Botões

Introdução

Nesta seção, você aprenderá como utilizar diferentes tipos de botões na API EuAtendo. Os botões são elementos interativos que podem ser utilizados para melhorar a experiência do usuário durante o atendimento, facilitando a execução de ações específicas de forma rápida e eficiente. Abaixo, detalhamos cada tipo de botão suportado:

  1. URL: Abre um link específico para o usuário, permitindo acesso direto a uma página da web.
  2. Call: Permite que o usuário faça uma ligação para um número de telefone.
  3. Copy: Copia automaticamente um texto ou código para a área de transferência do usuário.
  4. Reply: Envia uma resposta rápida, permitindo interação direta com o atendimento.

Obs: O parametro da imagem é um Thumb para envio da imagem junto, caso não queira uma imagem basta deixar vazio o parametro

Nesta documentação, vamos explorar cada um desses botões, apresentando exemplos práticos e dicas de uso para facilitar sua implementação e maximizar a eficiência do seu atendimento.

Botão URL

Caso de Uso

O botão URL é utilizado para direcionar o usuário para uma página específica na web. Ele pode ser muito útil para compartilhar informações adicionais, direcionar o usuário para um site de suporte, uma landing page promocional, ou qualquer outro recurso que complemente o atendimento.

Por exemplo, imagine que durante um atendimento o usuário esteja interessado em acessar sua fatura. Um botão URL pode ser disponibilizado para que ele seja direcionado diretamente para a página da fatura.

Implementação em Delphi

Abaixo, um exemplo de como implementar o botão URL usando Delphi para integrar com a API EuAtendo:

procedure TForm1.EnviarBotaoURL;
var
  Botao: TButtonTipo;
begin
  Botao.Tipo := 'url';
  Botao.Texto := 'Clique aqui para acessar sua fatura';
  Botao.Url := 'https://fatura.clientbase.com.br/de056ae8-16cd-4c45-a103-a6bfe2023850';
  
  // Envia o botão usando o método EnviarBotao
  ApiEuAtendo1.EnviarBotao('559982385000', 'Apidevs informa', 'Segue link da sua fatura em aberto.', 'Agradeçemos a preferência', Botao);
end;

Neste exemplo, criamos um objeto do tipo TButtonTipo e definimos suas propriedades, incluindo o tipo url, o texto do botão e a URL que o usuário deve acessar. Em seguida, utilizamos o método EnviarBotao do componente ApiEuAtendo1 para enviar o botão para o número de telefone especificado, com uma mensagem personalizada.

Botão Call

Caso de Uso

O botão Call é utilizado para permitir que o usuário faça uma ligação telefônica diretamente do atendimento. Isso é especialmente útil quando o usuário precisa de suporte imediato ou deseja entrar em contato com um setor específico da empresa.

Por exemplo, se o usuário precisar de ajuda com algum problema técnico, você pode disponibilizar um botão que o direciona a ligar diretamente para o suporte técnico.

Implementação em Delphi

Abaixo, um exemplo de como implementar o botão Call usando Delphi para integrar com a API EuAtendo:

procedure TForm1.EnviarBotaoCall;
var
  Botao: TButtonTipo;
begin
  Botao.Tipo := 'call';
  Botao.Texto := 'Clique aqui para ligar para o suporte';
  Botao.NumeroTelefone := '+5511999999999';
  
  // Envia o botão usando o método EnviarBotao
  ApiEuAtendo.EnviarBotao('559982385000', 'Apidevs informa', 'Precisa de ajuda? Ligue para o nosso suporte.', 'https://s33.apidevs.app/euatendo/10.png', 'Estamos sempre prontos para ajudar', Botao);
end;

Neste exemplo, criamos um objeto do tipo TButtonTipo e definimos suas propriedades, incluindo o tipo call, o texto do botão e o número de telefone que o usuário deve ligar. Em seguida, utilizamos o método EnviarBotao do componente ApiEuAtendo para enviar o botão para o número de telefone especificado, juntamente com uma mensagem personalizada que incentiva o usuário a entrar em contato com o suporte.

Botão Copy

Caso de Uso

O botão Copy é utilizado para copiar automaticamente um texto ou código para a área de transferência do usuário. Esse tipo de botão é muito útil em situações em que é necessário compartilhar códigos promocionais, números de referência ou outras informações que o usuário possa precisar utilizar em outra etapa do atendimento.

Por exemplo, se você estiver oferecendo uma promoção especial, um botão Copy pode ser disponibilizado para que o usuário copie o código promocional e o utilize em sua próxima compra.

Implementação em Delphi

Abaixo, um exemplo de como implementar o botão Copy usando Delphi para integrar com a API EuAtendo:

procedure TForm1.EnviarBotaoCopy;
var
  Botao: TButtonTipo;
begin
  Botao.Tipo := 'copy';
  Botao.Texto := 'Clique aqui para copiar o código promocional';
  Botao.Codigo := 'CODIGO_PROMOCIONAL';
  
  // Envia o botão usando o método EnviarBotao
  ApiEuAtendo.EnviarBotao('559982385000', 'Apidevs informa', 'Aproveite nosso código promocional.','https://s33.apidevs.app/euatendo/10.png',  'Copie o código abaixo e use em sua próxima compra', Botao);
end;

Neste exemplo, criamos um objeto do tipo TButtonTipo e definimos suas propriedades, incluindo o tipo copy, o texto do botão e o código que deve ser copiado. Em seguida, utilizamos o método EnviarBotao do componente ApiEuAtendo para enviar o botão para o número de telefone especificado, juntamente com uma mensagem personalizada incentivando o usuário a aproveitar o código promocional.

Botão Reply

Caso de Uso

O botão Reply é utilizado para enviar uma resposta rápida ao atendimento, permitindo que o usuário interaja diretamente e continue a conversa de forma automatizada. Este tipo de botão é útil para guiar o usuário em um fluxo de atendimento específico, como confirmar uma informação ou selecionar uma opção.

Por exemplo, se você deseja confirmar se o usuário está interessado em uma oferta, um botão Reply pode ser disponibilizado para que ele possa responder rapidamente e dar continuidade ao atendimento.

Implementação em Delphi

Abaixo, um exemplo de como implementar o botão Reply usando Delphi para integrar com a API EuAtendo:

procedure TForm1.EnviarBotaoReply;
var
  Botao: TButtonTipo;
begin
  Botao.Tipo := 'reply';
  Botao.Texto := 'Clique aqui para responder';
  Botao.Id := 'resposta_rapida_001';
  
  // Envia o botão usando o método EnviarBotao
  ApiEuAtendo.EnviarBotao('559982385000', 'Apidevs informa', 'Por favor, responda para continuar.','https://s33.apidevs.app/euatendo/10.png',  'Estamos aguardando sua resposta', Botao);
end;

Neste exemplo, criamos um objeto do tipo TButtonTipo e definimos suas propriedades, incluindo o tipo reply, o texto do botão e um identificador (Id) para a resposta rápida. Em seguida, utilizamos o método EnviarBotao do componente ApiEuAtendo para enviar o botão para o número de telefone especificado, juntamente com uma mensagem personalizada incentivando o usuário a responder rapidamente e continuar o fluxo de atendimento.

Utilizando Múltiplos Botões

Caso de Uso

A API EuAtendo permite o envio de até 3 botões em uma única mensagem. Esses botões podem ser do mesmo tipo ou de tipos distintos. Utilizar múltiplos botões é uma ótima maneira de fornecer opções variadas ao usuário, facilitando a interação e orientando-o para ações específicas. No entanto, o envio de mais de 3 botões pode ser perigoso, pois compromete a API.

Por exemplo, você pode combinar botões de URL, Copy e Call para oferecer várias opções ao usuário em uma única interação.

Implementação em Delphi

Abaixo, um exemplo de como implementar múltiplos botões usando Delphi para integrar com a API EuAtendo:

procedure TForm1.EnviarMultiplosBotoes;
var
  Botao1, Botao2, Botao3: TButtonTipo;
begin
  // Definindo o primeiro botão (URL)
  Botao1.Tipo := 'url';
  Botao1.Texto := 'Acesse nosso site';
  Botao1.Url := 'https://www.apidevs.com.br';

  // Definindo o segundo botão (Copy)
  Botao2.Tipo := 'copy';
  Botao2.Texto := 'Copie seu código promocional';
  Botao2.Codigo := 'PROMO2024';

  // Definindo o terceiro botão (Call)
  Botao3.Tipo := 'call';
  Botao3.Texto := 'Ligue para o suporte';
  Botao3.NumeroTelefone := '+5511999999999';

  // Enviando os botões usando o método EnviarMultiplosBotoes
  ApiEuAtendo.EnviarMultiplosBotoes('559982385000', 'Apidevs informa', 'Escolha uma das opções abaixo para continuar:','https://s33.apidevs.app/euatendo/10.png',  'Estamos aqui para ajudar', [Botao1, Botao2, Botao3]);
end;

Neste exemplo, criamos três objetos do tipo TButtonTipo e definimos suas propriedades. Utilizamos o método EnviarMultiplosBotoes do componente ApiEuAtendo para enviar os três botões ao usuário em uma única mensagem, proporcionando uma experiência rica e interativa.