Zenvia

A Zenvia é uma plataforma que permite a integração com canais como RCS e Facebook. Caso a sua empresa possua uma conta na Zenvia e ofereça atendimentos por meio do canal WhatsApp, poderá integrar este canal aos assistentes do Zenvia NLU, isso permitirá utilizar os assistentes e todos os recursos do Zenvia NLU sem a necessidade de trocar o número de atendimento que já é conhecido por seus clientes.

Configurações

Para começar, acesse a plataforma Zenvia NLU, vá em Connect > Canais > WhatsApp e clique em Zenvia para visualizar suas integrações. Na tela "Integrações com Zenvia", clique no botão ➕ para criar uma nova integração e preencha os seguintes campos:

• Nome: nome da sua integração

• Assistente: selecione o assistente

• Squads: selecione o nome da squad se estiver disponível na lista, caso contrário mantenha como “geral”

• Sender ID: o identificador do remetente da mensagem. O remetente é criado quando uma integração para o canal é conectada no console de integração. Copie o Sender ID da conta desejada em Integrações WhatsApp dentro da plataforma Zenvia

• API Token: token para autorização de envio de mensagens ao usuário. Você pode gerar seu token no console da API dentro da plataforma Zenvia

• Mensagens para mídias não suportadas: mensagens que serão exibidas caso o usuário envie um tipo de mensagem não suportado

• Telefones de Homologação: telefones para teste do fluxo de atendimento

Após criar a integração, volte para a tela de "Integrações com Zenvia" e clique no botão de editar integração para consultar suas URL's de Webhook. As mensagens enviadas pelos usuários para o seu número de WhatsApp deverão ser entregues nesta URL.

Utilize as informações da seção Webhooks de status para realizar a configuração em sua conta Zenvia. Estas informações são semelhantes às mostradas abaixo:

Exemplos:

1

{
  "external_id": "ab91e2a0-a46c-11eb-bf0a-9733e9a045ee",
  "status": "error",
  "destination": "[phone]",
  "date": "2021-04-23T16:47:01-03:00",
  "message": "The message was rejected by the provider"
}

2

{
  "external_id": "e47e5580-a46c-11eb-bf0a-9733e9a045ee",
  "status": "sent",
  "destination": "[phone]",
  "date": "2021-04-23T16:48:36-03:00"
}

3

{
  "external_id": "e47e5580-a46c-11eb-bf0a-9733e9a045ee",
  "status": "delivered",
  "destination": "[phone]",
  "date": "2021-04-23T16:48:37-03:00"
}

4

{
  "external_id": "e47e5580-a46c-11eb-bf0a-9733e9a045ee",
  "status": "read",
  "destination": "[phone]",
  "date": "2021-04-23T16:48:44-03:00"
}

Acesse a página inicial do portal Zenvia, vá em Produtos > Tokens e Webhooks para acessar o console da API.

Na seção Webhooks, clique no botão "Criar Novo" para criar um novo webhook e preencha os seguintes campos:

• Status: o status da subscrição. Deixe esta opção ativa

• Versão: a versão da subscrição. Selecione a opção v2

• Tipo do evento: o tipo do evento da subscrição. Selecione a opção Mensagem para receber mensagens dos usuários

• Canal: o canal da subscrição. Selecione a opção WhatsApp

• URL: URL usada para receber as mensagens de seus clientes. Consulte a URL na plataforma Zenvia NLU, em Entrada de Mensagens da seção Webhooks

• Cabeçalhos: informações de autenticação na chamada de webhook. Adicione um cabeçalho para AuthenticationToken. Consulte o cabeçalho na plataforma Zenvia NLU, no Header da seção Webhooks

Você também poderá gerenciar os seus webhooks utilizando a ZenAPI. Para mais informações consulte a documentação na seção Webhooks.