A integração entre Dito Agenda e 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.

Nesse artigo você entenderá como funcionam as variáveis utilizadas nas mensagens da integração. 

• Para quem é este artigo?

  • Nível de Acesso: Administrador, Editor, Administrador de Dados

Como usar as variáveis corretamente?

No uso padrão, ao clicar no botão do Whatsapp, nos abrimos o link estilo http://wa.me/5511998734455 , um link de redirecionamento para o Whatsapp que abre o aplicativo instalado no celular. 

Quando a integração com Omnichat é ativa, o link deixa de ser um redirecionador do Whatsapp, e se torna um redirecionador para o aplicativo/site da Omnichat!

Exemplo:

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 dentro dele 3 partes: 

1. O telefone do destinatário (chat?phoneNumber=)

2. O template da mensagem (&templateExternalId=)

3. As variáveis do Agenda (&templateParams=)

Ordem das variáveis 

As variáveis seguem uma ordem fixa na URL.

No exemplo:

templateParams=
(1) Franco
(2) Mariana
(3) Ribeirão Preto SP
(4) AA025
(5) 13 

Depois do &templateParams= temos:

Variável 1 = Franco (Nome do cliente)

Variável 2 = Mariana (Nome do vendedor)

Variável 3 = Ribeirão Preto SP (Nome da loja)

Variável 4 = AA025 (Código do vendedor)

Variável 5 = 13 (Código da loja)

A ordem é fixa dentro da URL, e para elas preencherem as variáveis na omnichat, é necessário respeitar essa ordem.

Para uma variável ser incluída na omnichat, cada Slot de variável presente no template de mensagem será preenchida com variável correspondente na ordem preenchida da URL

Nesse exemplo eu tenho 3 variáveis, logo, a omnichat preenche na ordem das 3 variáveis do Link

Variável 1 = Franco (Nome do cliente)

Variável 2 = Mariana (Nome do vendedor)

Variável 3 = Ribeirão Preto SP (Nome da loja)

https://omni.chat?/phoneNumber=553132620120&templateExternalId=0f2e1d7d-2776-493c-a912-2654949c9c33
&templateParams= (1)Franco , (2)Mariana , (3)RIBEIRAO%20PRETO%20-%20SP , (4)AA025 , (5)13

Caso eu deseje utilizar as variáveis 4 e 5, tenho que criar mais campos de variável na omnichat.

Não é possível:

1. Usar variáveis selecionadas: caso o usuário deseje usar a variável 5, ele precisa obrigatoriamente usar as variáveis 1, 2, 3 e 4 também

2. Incluir novas variáveis

3. Alterar a ordem das variáveis, não é possível transformar a variável 5 em variável 1. É um padrão imutável.

Leia Também:

• Artigo: Dito Agenda:  Visão geral Integração Dito Agenda + Omnichat

FAQ – Perguntas Frequentes sobre uso de variáveis na integração com OmniChat 

1. Por que minhas variáveis não estão sendo preenchidas corretamente na mensagem?

Isso geralmente acontece quando a ordem das variáveis na URL não corresponde à ordem esperada no template da OmniChat. Como a ordem é fixa, qualquer desalinhamento impede o preenchimento correto.

2. É 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 da OmniChat?

Não. O preenchimento das variáveis segue uma hierarquia rígida e sequencial. Para utilizar a variável 3, você é obrigado a configurar e consumir as variáveis 1 e 2 anteriormente no seu template. O sistema da OmniChat preencherá os slots na ordem em que aparecem na URL da Dito.

 3. O que acontece se o meu template na OmniChat tiver 5 slots de variáveis, mas a URL da Dito enviar apenas 3 parâmetros? 

Os dois últimos slots do template na OmniChat ficarão vazios ou apresentarão erro de preenchimento, pois a integração consome os dados na ordem fixa. Para que todos os 5 campos funcionem, a URL deve conter todos os parâmetros correspondentes e o template deve estar preparado para recebê-los.

 4. Como a OmniChat diferencia o link de redirecionamento padrão do WhatsApp do link da integração?

A principal diferença está na estrutura da URL. Enquanto o uso padrão utiliza o domínio wa.me, a integração ativa transforma o botão do WhatsApp em um disparador para o domínio da OmniChat (app.omni.chat), incluindo automaticamente o templateExternalId e os templateParams que não existem no link convencional.

5.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 à integração? 

De acordo com a documentação atual, 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 para garantir a estabilidade e o padrão de auditoria entre as plataformas.

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)