Integração e configuração de número WhatsApp API
Com o Token da API e o Integration ID copiados, realize a integração e configuração do número WhatsApp Business API no Citrus, conforme as orientações a seguir:
1. Acesse a plataforma Citrus com um usuário Administrador.
2. No menu lateral clique em Administração.
3. Entre em Configurações Gerais.
4. Na coluna à direita da tela, acesse WhatsApp (Configuração geral do WhatsApp).
*O formulário para preencher as informações para o canal WhatsApp será aberto na tela.
Preencha os campos como a seguir:
- Broker: Selecione que a integração é com o Broker DCS.
- Token da API: Número do token da API do cliente no DCS assim que ele é cadastrado.
- Habilitado: Marque a caixa de seleção.
- Tratar todas as mensagens de entrada através do atendimento: Este recurso encontra-se em análise. Por esta razão, deve ficar desmarcado.
- URL do webhook: Este URL é composto pelo URL que identifica cada cliente + “/message/webhook”. Por padrão, é preenchido com o URL do cliente Citrus.cx.
Caso seja necessário criar uma ativação informando o URL de um cliente, que não o Citrus.cx, a primeira parte do URL deve ser a obtida em DCS > Clientes > Editar cliente (que terá URL usada) > (campo) URL de Callback.
Para conseguir cadastrar outro URL de cliente no Citrus é preciso acessar Citrus > Administração > Configurações Gerais > Geral (Configurações gerais do sistema) > (campo) URL e inserir no novo URL.
- Token do webhook: Este token é gerado automaticamente após preencher e salvar este formulário de cadastro no Citrus.
5. Ao realizar uma ativação pela primeira vez, após preencher os campos do formulário à esquerda da tela, será preciso clicar em Salvar para confirmar o registro dos dados.
6. Em “Números Integrados” à direita do formulário devem ser preenchidos os dados que identificam o número de WhatsApp que será integrado ao Citrus:
- Nome: Informe o nome que o Cliente Digivox utilizará no WhatsApp (como se identificará no WhatsApp ao enviar mensagens para o cliente final dele).
- Número: Número do WhatsApp que será utilizado pelo cliente para enviar e receber mensagens para o cliente final dele. É obrigatório preencher o número com DDI+DDD+número (todos os caracteres juntos, sem espaços). Exemplo de número celular: 5583999998888.
- Integration ID: Código do Integration ID do número WhatsApp do cliente (veja como Encontrar o Token da API e o Integration ID do número do cliente).
7. Pressione Adicionar para concluir a integração.
![](https://docs.citrus.cx/wp-content/uploads/2023/10/DCS_Integracao-Citrus_plataforma-Citrus.gif)
A partir da integração no Citrus, será possível configurar vários números de uma empresa (cliente Digivox) pelos campos de “Números Integrados”. Por exemplo, os números de uma empresa que tem um WhatsApp para a matriz e outros números para as suas filiais.
IMPORTANTE
- Um cliente pode ter vários números de WhatsApp. Cada número tem seu próprio código Integration ID.
- Cada cliente terá apenas um Token da API, independentemente da quantidade de números de WhatsApp associados a ele.