Para enviar mensagens para o WhatsApp de seus contatos através de outros sistemas, é preciso fazer uma integração com Webhook.
Toda mensagem ativa (mensagem template), aprovada pelo WhatsApp, possui uma URL única que habilita o disparo diante de algum gatilho exigido pelo software que envia o Webhook.
Para garantir que o lead seja recebido no Duotalk pelo mesmo operador que já o gerencia no seu CRM, as requisições HTTP precisam passar obrigatoriamente o campo operator (contendo o e-mail do atendente), além dos campos padrão name e phone.
Configuração da Estrutura do JSON (Body)
Ao estruturar a integração no seu sistema ou CRM, certifique-se de preencher os blocos do objeto JSON enviado no corpo (body) da seguinte forma:
name: Nome do destinatário/contato que receberá a mensagem. (Ex: "João Silva")
phone: Telefone do destinatário. Deve conter o código do país (DDI), código de área (DDD) e o número, apenas com algarismos e sem caracteres especiais. (Ex: "5511958876082")
operator: E-mail do operador correspondente registrado no CRM. Esse campo é o responsável por vincular e direcionar o lead para a mesma pessoa dentro da plataforma Duotalk. (Ex: "[email protected]")
Observação Importante:
Caso o seu template possua variáveis personalizadas, é necessário incluir as chaves correspondentes diretamente no body da sua requisição.
Exemplo de estrutura incluindo a variável customizada {MODELO_VEÍCULO}:
URL: URL única informada na área de configuração do template no painel Duotalk (https://app.duotalk.io).
Cabeçalho (Headers):
queryParams: true (Define parâmetros de consulta)
intention: DEPARTAMENTO (Departamento onde a mensagem será entregue)
provider: 3 (Provedor 3, padrão para sistemas de terceiros)
providerName: SISTEMA B (Nome do provedor do disparo do gatilho)
Parâmetros POST (Body):
name: Nome do Destinatário (Inserir nome do contato).
phone: Telefone Destinatário (Formato: DDI + DDD + TELEFONE. Ex: 5511958876082).
operator: E-mail do Operador (Indica o atendente do CRM responsável pelo lead).
[NOME_DA_VARIAVEL]: Chave correspondente a qualquer variável dinâmica do seu template (Ex: MODELO_VEÍCULO).
Sandbox Endpoint de Exemplo: https://api.duotalk.io/p/campaign/send/633dbb46aebd6756ce153523/3164299590501637?queryParams=true&intention=Vendas&provider=3
