Detalhes do pedido
Introdução
O modelo de mensagens do pedidos no Opa! Suite permitem criar mensagens estruturadas para processar transações financeiras diretamente pelo WhatsApp. Esta funcionalidade facilita cobranças e pagamentos de forma segura e integrada.
A API de pagamento da Meta atualmente oferece suporte somente para métodos brasileiros (Pix, Link de pagamento e Boleto bancário). Portanto, não é possível utilizar essa implementação para cobranças internacionais.
Casos de uso
- Permitido o envio de link de pagamento, código Pix e boleto, disponibilizado no botão de ação para o usuário(Enviar segunda via na tela de ações de atendimento)
- No fluxo deverá ser possível enviar o template de detalhes do pagamento no card de Segunda Via de Cobrança;
Acesso aos Modelos de mensagens
Para acessar e gerenciar os Templates de Mensagens, siga estes passos:
Caminho: Menu (Opa! Store -> Canal do WhatsApp -> Modelo de mensagens(Templates de Mensagem))
Criação do Modelos de detalhes do pedido
A mensagem do modelo deve ser clara e objetiva.
- Acesse a área de Modelos de mensagem.
- Clique em Adicionar novo.
- Preencha o Nome do Modelo de mensagem;
- Defina o Idioma;
- Selecione o tipo: Detalhes do pedido;
- Defina quais departamentos terão acesso ao modelo;
- Selecione Continuar;
- Caso deseje, insira cabeçalho ou rodapé.
- Insira o Texto de corpo;
- Clique em Enviar para análise da Meta.
Após o envio, o template será analisado pela Meta.
Quando aprovado, será necessário:
- Substituir as variáveis (se houver);
- Definir um nome de atalho para facilitar seu uso.
O modelo detalhes do pedido não poderão ser enviadas através do envio em massa ou individual.
Variáveis disponíveis no corpo
Ao preencher o texto de corpo, é possível inserir variáveis de personalização através do menu do editor. As variáveis disponíveis para este tipo de template são:
| Variável | Descrição |
|---|---|
| Nome da empresa |
| Nome do cliente |
| Nome do contato |
| Nome do atendente |
| Número do protocolo |
| Data de vencimento da fatura |
O texto do corpo não pode começar nem terminar com uma variável.
Como o valor de cada variável é preenchido
No momento do envio, o sistema substitui cada variável pelo valor correspondente. Esse valor pode vir de duas origens:
- Dados do atendimento — variáveis como
,esão resolvidas automaticamente a partir do atendimento em andamento (identificado peloidAtendimento). - Dados enviados pelo ERP — a variável
é a única exceção: seu valor não vem do atendimento, e sim do campodataVencimentoinformado no payload da requisição à API, no momento do disparo do template.
A sempre representa a última data de vencimento da fatura, inclusive em casos de renegociação. O valor apresentado depende do envio atualizado dessa informação do seu ERP.
O que acontece se o valor não for informado:
Caso uma variável não possa ser resolvida no momento do envio da mensagem, por exemplo, quando o ERP não fornecer o campo dataVencimento ou quando a API for acionada sem o parâmetro idAtendimento para variáveis como , o sistema utilizará um mecanismo de fallback.
Nessas situações, em vez do valor esperado, será exibido o identificador da própria variável no conteúdo da mensagem. Por exemplo, o destinatário poderá visualizar o texto data_vencimento no lugar da data correspondente.
Para evitar que o cliente final receba o nome da variável em vez do valor real, garanta que o ERP sempre envie dataVencimento ao disparar templates que utilizem essa variável.
Durante a configuração do modelo de mensagem, a opção Data de vencimento aparece no passo Finalizar registro, disponível exclusivamente para modelos de mensagem do tipo Detalhes do pedido.
URL dinâmica no botão de link de pagamento
No botão do tipo Acessar Site, é possível adicionar uma variável ao final da URL, tornando o link dinâmico e personalizado para cada destinatário. Com isso, cada cliente recebe o botão apontando para o seu link específico, como um boleto individualizado ou página de pagamento, com um único clique, sem necessidade de incluir o link no corpo da mensagem.
Regras da variável:
- A variável deve ser inserida no formato
- Só pode ser posicionada ao final da URL (ex:
https://site.com.br/)
Envio via API:
Ao utilizar a API do Opa! Suite, a variável da URL é definida no campo variaveis. Se o modelo de mensagem contiver essa variável, ela deve ser a última informada na requisição.
Este recurso está disponível exclusivamente para modelos de mensagem criados com o Broker Opa! Suite.
Categoria da Mensagem: Utilitário ou Marketing
Durante a criação, o modelo detalhes do pedido podem ser enviados com a categoria: Utilitário, pois tratam de transações e cobranças.
Modelos classificados como Marketing estão sujeitos a limitações de envio. Mesmo que a API retorne sucesso na requisição, a entrega ao usuário pode ser bloqueada caso a conta ultrapasse os limites impostos pelo WhatsApp Business API. ## Fluxo de Processo
Informações importantes
- Para ser encaminhado o modelo de segunda via ou Pix com a opção de copiar, é necessário implementar um card condicional no fluxo de atendimento, posicionado antes do card
**SegundaViaCobranca**. - Ao configurar um modelo do tipo pedido o sistema entenderá que deve ser enviado quando o usuário faz a ação de envio de segunda via.
- Quando houver mais de um modelo do pedido aprovado, o sistema sempre enviará o mais recente.
- A Meta pode reclassificar o template como Marketing durante a validação.
- Os dados da cobrança (valor, vencimento, chave Pix, link de pagamento etc.) não precisam ser inseridos na criação do modelo. Eles serão preenchidos via requisição à API do sistema ERP, no momento do envio.
O modelo detalhes do pedido funcionará apenas com o Broker Opa! Suite
Considerações Finais
A funcionalidade do modelo de detalhes do pedido foi criada para garantir praticidade, padronização e segurança nos atendimentos via WhatsApp, especialmente quando há necessidade de segunda via ou nova tentativa de cobrança. A lógica de envio, feita com base no canal e no fluxo configurado, garante que o usuário final receba a mensagem correta com os dados atualizados em tempo real via ERP.
Etiquetas
#WhatsApp #BrokerOpa #TemplatePagamento #Cobranca