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.

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: Não. Atualmente, não é possível incluir novas variáveis além das cinco pré-definidas (Nome do Cliente, Nome do Vendedor, Nome da Loja, Código do Vendedor e Código da Loja). A integração está limitada a esses campos fixos.

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.