A integração entre a Dito Agenda e a OmniChat permite que os vendedores enviem mensagens para clientes utilizando um número de WhatsApp verificado, garantindo mais controle, rastreabilidade e auditoria das comunicações da marca. Neste artigo, você entenderá como funcionam as variáveis utilizadas nas mensagens da integração.

• Nível de Acesso: Administrador, Editor, Administrador de Dados
  Persona: Analista de CRM, Gerente de Loja, Vendedor

Entendendo a URL da integração

No uso padrão, ao clicar no botão do WhatsApp, nós abrimos um link no estilo http://wa.me/5511998734455, que redireciona para o aplicativo do WhatsApp instalado no celular. Quando a integração com a OmniChat está ativa, o link se torna um redirecionador para o aplicativo ou site da OmniChat.

Exemplo de URL da integração:

https://app.omni.chat/#/home/chat?phoneNumber=553132620120&templateExternalId=0f2e1d7d-2776-493c-a912-2654949c9c33&templateParams=Franco,Mariana,RIBEIRAO%20PRETO%20-%20SP,AA025,13

Esse link contém 3 partes principais:

1. O telefone do destinatário (chat?phoneNumber=)
2. O template da mensagem (&templateExternalId=)
3. As variáveis da Dito Agenda (&templateParams=)

Ordem e Funcionamento das Variáveis

As variáveis seguem uma ordem fixa na URL. No parâmetro &templateParams=, os valores são separados por vírgula e correspondem a uma informação específica, sempre na mesma sequência.

Usando o exemplo anterior, a ordem é:

Variável 1 = Franco (Nome do cliente)
Variável 2 = Mariana (Nome do vendedor)
Variável 3 = RIBEIRAO PRETO - SP (Nome da loja)
Variável 4 = AA025 (Código do vendedor)
Variável 5 = 13 (Código da loja)

Para que a OmniChat preencha as variáveis corretamente no template da mensagem, é fundamental que a ordem dos campos no template corresponda à ordem fixa enviada pela Dito na URL.

Regras e Limitações

Regras Importantes:

- Uso Sequencial Obrigatório: Para usar uma variável (ex: a variável 5), você precisa obrigatoriamente incluir todas as anteriores (1, 2, 3 e 4) no seu template.

- Sem Novas Variáveis: Não é possível incluir variáveis personalizadas além das cinco pré-definidas.

- Ordem Imutável: A ordem das variáveis é fixa e não pode ser alterada. A variável 5 sempre será a quinta na sequência da URL.

Diferença no uso de variáveis entre Campanhas do Agenda e Campanhas em Massa (Segmento/Comportamento)

É importante notar que as regras e limitações de variáveis mencionadas acima (Nome do Cliente, Nome do Vendedor, Nome da Loja, Código do Vendedor e Código da Loja) aplicam-se especificamente às campanhas criadas no módulo Agenda, onde as variáveis são vinculadas ao vendedor via integração específica.

Para campanhas de WhatsApp disparadas em massa (seja por segmento ou comportamento) através da integração com a Omnichat, a lógica para variáveis personalizadas é diferente. Variáveis como DATA_CUPOM_VENDEDOR, que não fazem parte das cinco variáveis fixas do Agenda, precisam ser cadastradas como uma característica na ficha do cliente no app.dito.com.br.

Como utilizar variáveis personalizadas em campanhas de WhatsApp em massa:

- Cadastre a informação como característica do cliente: Certifique-se de que o "cupom do vendedor" ou qualquer outra informação personalizada esteja registrada como uma característica na ficha do cliente na plataforma Dito. Uma forma de fazer isso é segmentar os clientes por vendedor de preferência, exportar os dados e reimportar o cupom como um novo campo na ficha do cliente.

- Crie templates genéricos na Omnichat: Na Omnichat,  crie templates de mensagem com variáveis genéricas (ex: {{1}}, {{2}}).

    - Dito popula as variáveis: A plataforma Dito enviará o ID do template para a Omnichat com as variáveis correspondentes, que serão populadas com os dados da ficha do cliente (neste caso, a característica do cupom) ou do Dito Agenda, conforme a origem da campanha.

Essa distinção garante que a flexibilidade de personalização seja mantida para campanhas em massa, utilizando a estrutura de características do cliente.

FAQ – Perguntas Frequentes

1. Pergunta: Por que minhas variáveis não estão sendo preenchidas corretamente na mensagem?
Resposta: Isso geralmente acontece quando a ordem das variáveis no template da OmniChat não corresponde à ordem fixa enviada na URL da Dito Agenda. Qualquer desalinhamento impede o preenchimento correto.

2. Pergunta: É possível pular a variável "Nome do Vendedor" (2) e usar apenas o "Nome do Cliente" (1) e o "Nome da Loja" (3) no meu template?
Resposta: Não. O preenchimento é sequencial. Para utilizar a variável 3, você é obrigado a configurar e consumir as variáveis 1 e 2 no seu template. A OmniChat preencherá os campos na ordem em que eles aparecem na URL.

3. Pergunta: O que acontece se meu template na OmniChat tiver 5 espaços para variáveis, mas a URL da Dito enviar apenas 3?
Resposta: Os dois últimos espaços do template ficarão vazios ou apresentarão erro, pois a integração consome os dados na ordem recebida. Para que todos os 5 campos funcionem, o template deve estar preparado para receber todos os parâmetros.

4. Pergunta: Como a OmniChat diferencia o link padrão do WhatsApp do link da integração?
Resposta: A principal diferença está na estrutura da URL. O uso padrão utiliza o domínio wa.me, enquanto a integração ativa o domínio da OmniChat (app.omni.chat), que inclui parâmetros específicos como templateExternalId e templateParams.

5. Pergunta: Se eu precisar de uma informação que não está na lista das 5 variáveis padrão (como o CPF do cliente), posso adicioná-la?
Resposta:Sim! Para campanhas de WhatsApp disparadas em massa (Segmento ou Comportamento) via Omnichat, você pode cadastrar a informação como uma característica do cliente na plataforma Dito e vinculá-la a variáveis genéricas no template da Omnichat. A limitação das 5 variáveis fixas aplica-se apenas às campanhas criadas direto no módulo Dito Agenda.

Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)

Tags: Dito Agenda, Omnichat, integração WhatsApp, variáveis Omnichat, templateParams, templateExternalId, ordem das variáveis, Dito Omni, como usar variáveis, erro variáveis omnichat, Dito Agenda WhatsApp, automação de mensagens, parâmetros de URL.