Categories
Módulos API

Infobip

A integração via Infobip permite trabalhar com o WhatsApp (Business) oficial e Viber.

Princípio de integração com o WhatsApp Business

Ao trabalhar com o WhatsApp Business, você encontrará restrições, como uma janela de 24 horas para correspondência padrão:

  • Você tem 24 horas para responder a uma mensagem enviada por um cliente. A contagem regressiva de 24 horas começa sempre que um cliente lhe envia uma mensagem.

Decorrido esse tempo, somente poderá ser enviado um template previamente acordado com a Infobip.


No Usedesk, para trabalhar com o canal WhatsApp Business e suas nuances, implementamos:

  • Solicitações de entrada e respostas a eles dentro de 24 horas;
  • Dicas sobre a limitação de 24, na forma de erro na ficha de solicitação com link para o artigo atual;

  • Trabalhar com modelos pré-acordados;
  • Inicialização de um diálogo com um cliente;
  • Tratamento de vários erros que exibimos na interface. Por exemplo, "Falha ao enviar um anexo, tamanho excedido (imagens de até 5 MB, arquivos de até 100 MB)" e outros.

Conectando o WhatsApp Business

Para conectar o WhatsApp Business ao Usedesk, abra a seção "Extensões" e habilite a integração na lista geral. Esta opção está paga.

1. Vá para "Canais" - "WhatsApp Business", clique em "Adicionar".

2. Faça login em sua conta da Infobip. Na página https://www.infobip.com/docs/api, copie o URL da API e cole-o no campo de mesmo nome do canal criado (p.1)


3. Na página , crie ou copie uma chave de API. Cole-o no campo "Token" do canal criado (p. 1)


4. Na página, copie o número de telefone conectado e cole-o no campo "Número de telefone" do canal criado (p. 1)


5. Após preencher os campos acima no canal Usedesk, clique no botão "Salvar"

O sistema irá gerar automaticamente um webhook.

6. Na página, clique no número conectado e, na janela que aparecer, clique em "Adicionar uma palavra-chave"

7. Na janela que aparece, preencha os campos:

  • Encaminhamento - Encaminha para HTTP;
  • Método - POST;
  • URL - Webhook do item 5

Você não precisa preencher a palavra-chave (deixe o campo em branco).

Feito!

Usando o WhatsApp Business

1. Processando solicitações de entrada

Os clientes podem escrever para o número de telefone conectado. A mensagem do cliente vai para a seção "Bate-papos" e a seção "Tickets". Responda de qualquer seção a uma mensagem do cliente.

Tickets:

Chats:

Lembre-se da janela de 24 horas para correspondência padrão ao responder a uma mensagem.

Se 24 horas se passaram desde a última mensagem do cliente, você precisará usar um modelo pré-acordado com a Infobip para responder. Em que:

  • O campo para envio de mensagem padrão ficará inativo;
  • O envio de um comentário interno está disponível;
  • O botão "Enviar" será alterado automaticamente para "Enviar modelo";
  • Quando você clica no botão "Enviar modelo", uma janela modal aparece para selecionar um modelo;
  • Uma mensagem informativa aparece quando o modelo é enviado;

2. Inicialização do diálogo

Na seção "Bate-papo", você pode exibir o botão para criar um diálogo no Whatsapp Business - "Criar um bate-papo", que permitirá que você inicie uma conversa com seus clientes de forma independente. A inicialização do diálogo é imprescindível para usar modelos pré-acordados.

Isto exige:

  • Conecte o canal Whatsapp Business;
  • Configure as permissões de acesso do agente para este canal , que tem o Whatsapp Business habilitado. Se o agente não tiver permissões de acesso a tal canal, este botão estará ausente, inclusive ao atribuir um chat a ele ou se você tiver permissões de administrador.

Se você tem vários canais com o Whatsapp, ao usar o botão "Criar Chat", você pode escolher qual canal e para quem vai escrever primeiro.

Escreva para o cliente preenchendo os campos:

  • Canais - selecione um canal do Whatsapp Business;
  • Cliente - insira o nome do cliente e, na lista suspensa, selecione para quem você escreverá. Se você precisar criar um novo cliente, escreva o nome. Se a pesquisa não retornou nenhum resultado - clique em "Novo cliente".
  • Telefone - insira o número de telefone no formato internacional (sem indicar +) XXXXXXXXXX (por exemplo, para a Federação Russa, o número será semelhante a 79254321098 e para Bielo-Rússia - 375296787656) ou selecione um cliente de seu banco de dados e o número será fornecido automaticamente.
  • Nome do modelo - selecione o modelo que você usará para enviar sua mensagem. Você coordenou os nomes dos modelos com a Infobip. Se você tiver variáveis no modelo, especifique-as também nos campos apropriados.

Um exemplo de preenchimento dos campos:

Princípio de integração com o Viber

No Usedesk, para trabalhar com o canal Viber e suas nuances, implementamos:

  • Solicitações de entrada e respostas a eles;
  • Tratamento de vários erros que exibimos na interface. Por exemplo, "Falha ao enviar um anexo, tamanho excedido (imagens de até 5 MB, arquivos de até 100 MB)" e outros.

Conexão com o Viber

Para conectar o Viber ao Usedesk, abra a seção "Extensões" e habilite a integração na lista geral. Esta opção está paga.

1. Vá para a seção "Canais" - "Viber (infobip)," clique em "Adicionar".

2. Faça login em sua conta da Infobip . Na página https://www.infobip.com/docs/api, copie o URL da API e cole-o no campo de mesmo nome no canal criado (p. 1)


3. Crie ou copie uma chave de API na página. Cole-o no campo "Token" do canal criado (p. 1)


4. Na página, copie o que está indicado no campo de informação e cole no campo "Número de telefone" do canal criado (pág. 1). No exemplo, temos a ROYAL CANIN


5. Após preencher os campos acima no canal Usedesk, clique no botão "Salvar"

O sistema irá gerar automaticamente um webhook.

6. Na página, clique no número conectado e na janela que aparecer, clique em "Adicionar uma palavra-chave"


7. Na janela que aparece, preencha os campos:

  • Encaminhamento - Encaminha para HTTP;
  • Método - POST;
  • URL - Webhook do item 5

Você não precisa preencher a palavra-chave (deixe o campo em branco).


Feito!

Usando o Viber

1. Processamento de tickets de entrada

Os clientes podem escrever para você no Viber que você conectou. A mensagem do cliente vai para a seção "Bate-papos" e a seção "Tickets". Responda de qualquer seção a uma mensagem do cliente.

Tickets:

Chats:

Importante! O Viber Infobip não sabe trabalhar com arquivos. Fotos do Usedesk são enviadas como um link


Was the article helpful?

Yes No