Chat Pró Oratrix: Como enviar Template Variável em massa pela API Oficial
SERVIÇO
Serviço: Chat Pró Oratrix
VOCÊ VAI PRECISAR
- Acesso ao Chat Pró Oratrix.
- Perfil Administrador, Supervisor ou Usuário.
- Uma conexão API Oficial (WABA) ativa.
- Um Template WABA aprovado com as variáveis que serão preenchidas no disparo.
- A lista de números e valores das variáveis, digitada manualmente ou preparada em arquivo CSV.
VISÃO GERAL
A opção Envio em Massa - Template Variável API Oficial permite disparar templates WABA com informações diferentes para cada destinatário.
Esse recurso é indicado quando cada contato precisa receber a mesma estrutura de template, mas com dados personalizados, como nome, produto ou outra informação vinculada às variáveis do modelo aprovado.
PASSO A PASSO GUIADO
1. Acesse o Envio em Massa de Template Variável
- Acesse o Chat Pró Oratrix pelo endereço informado pela Oratrix.
- Faça login utilizando seu usuário e senha.
- No menu lateral, clique em Comunicação e Marketing.
- Abra Envio em Massa.
- Selecione Template Variável API Oficial.
- Aguarde o carregamento do formulário.
Essa aba exige uma conexão pela API Oficial (WABA).
TÓPICO 1 - SELECIONE A CONEXÃO WABA
- Localize o campo WhatsApp / Conexão.
- Selecione a conexão WABA que será utilizada no disparo.
- Confirme que escolheu a conexão correta antes de continuar.
TÓPICO 2 - DEFINA O INTERVALO ENTRE OS ENVIOS
Use os campos:
- Min (s) — intervalo mínimo, em segundos.
- Max (s) — intervalo máximo, em segundos.
O sistema sorteia um valor aleatório entre esses dois números para cada mensagem enviada.
- Informe o valor mínimo em Min (s).
- Informe o valor máximo em Max (s).
- Revise os dois campos antes de iniciar o disparo.
TÓPICO 3 - CONFIGURE AS AÇÕES DO TICKET
Antes do envio, configure conforme a necessidade da operação:
- Fechar ticket.
- Atribuir fila.
- Atribuir usuário.
Revise essas opções antes de continuar, porque elas definem como o atendimento ficará relacionado ao disparo.
TÓPICO 4 - SELECIONE O TEMPLATE
- Localize o campo Template.
- Selecione o template WABA aprovado que será utilizado.
- Confira quantas variáveis existem no template.
- Prepare os dados respeitando a mesma ordem dessas variáveis.
As variáveis precisam corresponder às colunas preparadas para o envio, como:
var1, var2, var3…
A ordem das variáveis no arquivo ou no campo de dados precisa acompanhar a ordem esperada pelo template.
TÓPICO 5 - PREPARE NÚMEROS E VARIÁVEIS
No campo Números e variáveis, informe uma entrada por linha no formato:
número,var1,var2,...
Exemplos:
5511999999999,João,Produto A
5521888888888,Maria,Produto B
Se uma variável possuir vírgula no próprio conteúdo, coloque esse valor entre aspas duplas:
5511999999999,"Olá, João",Produto A
Regras de preenchimento
- Use um registro por linha.
- Não deixe linhas em branco entre os registros.
- Se uma variável contiver vírgula, envolva o conteúdo em aspas duplas.
- Não use quebras de linha dentro do conteúdo de uma variável.
- Mantenha todos os dados daquele destinatário em uma única linha.
TÓPICO 6 - IMPORTAR OS DADOS POR CSV
Também é possível utilizar a opção Importar CSV.
- Prepare o arquivo com a coluna do número e as variáveis na ordem esperada pelo template.
- Na tela de envio, clique em Importar CSV.
- Selecione o arquivo.
- Aguarde a importação.
- Confira os dados carregados antes de iniciar o disparo.
TÓPICO 7 - REGRA DO 9º DÍGITO NO BRASIL
O sistema valida os números de acordo com a regra brasileira documentada para essa funcionalidade.
| Tipo de número | DDD | Formato correto |
|---|---|---|
| Telefone fixo — primeiro dígito após o DDD entre 1 e 4 | qualquer | Sem o 9º dígito |
| Celular — capitais e regiões metropolitanas | DDD menor que 30 | Com o 9º dígito |
| Celular — interior | DDD maior ou igual a 30 | Sem o 9º dígito |
TÓPICO 8 - ENTENDA A NORMALIZAÇÃO DOS NÚMEROS
Durante a importação, o sistema pode tratar os números das seguintes formas:
Duplicatas
Depois da normalização, números duplicados são mesclados automaticamente. O sistema informa quais registros foram agrupados.
Números divergentes da regra
Números que não estiverem de acordo com a regra são marcados com um aviso.
Variantes do mesmo contato
Um mesmo número informado em formatos diferentes, como com e sem o 9º dígito, pode gerar um novo contato no banco quando não estiver de acordo com a normalização esperada.
Por isso, revise os números antes do disparo para evitar duplicidade na base.
Padronização recomendada
Antes de importar:
- normalize o 9º dígito conforme o DDD;
- remova espaços;
- remova traços;
- remova parênteses.
TÓPICO 9 - REALIZE O ENVIO
Depois de revisar a conexão, template, intervalos, ações do ticket e dados dos destinatários, escolha o tipo de disparo.
Enviar
Clique em Enviar para realizar o disparo dentro da janela de 24 horas.
Enviar Marketing
Clique em Enviar Marketing para campanhas fora da janela de 24 horas da Meta.
Essa opção utiliza a categoria de template Marketing.
NÃO FECHE A PÁGINA DURANTE O DISPARO
O progresso do envio é processado pelo navegador.
Aguarde até que o processamento seja concluído antes de sair da tela.
OBSERVAÇÕES IMPORTANTES
- Esta funcionalidade exige uma conexão API Oficial (WABA).
- Está disponível para os perfis Administrador, Supervisor e Usuário.
- Utilize somente um Template aprovado.
- As variáveis precisam estar na mesma ordem esperada pelo template.
- Use um registro por linha e não insira quebras de linha dentro das variáveis.
- Variáveis que contêm vírgulas precisam ficar entre aspas duplas.
- Revise a regra do 9º dígito antes de importar a base.
- Números divergentes da regra recebem aviso, mas ainda podem seguir para envio como foram digitados.
- Variantes do mesmo número podem gerar contatos duplicados.
- Não feche a página enquanto o disparo estiver em andamento.
DICAS E BOAS PRÁTICAS
- Faça um teste com poucos destinatários antes de um envio maior.
- Confira o template e a ordem das variáveis antes de importar o CSV.
- Padronize os números antes do envio.
- Remova espaços, traços e parênteses da lista.
- Revise os avisos apresentados após a importação.
- Verifique se as opções de Fechar ticket, Atribuir fila e Atribuir usuário estão de acordo com o fluxo desejado.
- Mantenha a página aberta até o término do processamento.
RESULTADO ESPERADO
Depois de concluir a configuração, o Chat Pró Oratrix realizará o disparo do template WABA para os destinatários informados, preenchendo as variáveis individualmente conforme os dados de cada linha ou registro importado.
O envio utilizará a conexão WABA selecionada e seguirá a opção escolhida entre Enviar ou Enviar Marketing.
RESUMO FINAL
Para enviar um Template Variável em massa pela API Oficial, selecione a conexão WABA, configure os intervalos e ações do ticket, escolha o template aprovado e informe os números com suas respectivas variáveis.
Revise a normalização dos números, escolha o tipo de envio correto e mantenha a página aberta até o processamento terminar.
KEYWORDS
WABA, Template Variável, envio em massa, API Oficial, Chat Pró Oratrix
Peça ajuda ao ChatGPT da Oratrix
A I.A. da Oratrix no ChatGPT poderá tirar dúvidas e te guiar passo a passo no suporte.