Pular para o conteúdo principal

Como Criar e Enviar Mensagens Ativas de Pagamento no Blip

  • Atualizado

Importante: este produto está em Alpha e não está disponível para uso geral. A liberação ocorre mediante solicitação via KAM, AM ou CSM, com validação do time de Payments.

Canal disponível: WhatsApp

 

Introdução: Mensagens Ativas de Pagamento

As Mensagens Ativas de Pagamento permitem que sua marca envie solicitações de pagamento diretamente pelo WhatsApp, de forma segura e integrada à experiência do cliente.

Esse tipo de mensagem pode ser usado para lembrar o cliente de um pagamento pendente, enviar o resumo de um pedido ou até uma promoção personalizada para concluir uma compra. Tudo isso sem depender de o cliente iniciar a conversa.

No Blip, esse processo pode ser configurado de forma inteligente, automatizada e estratégica.

 

Criando o Modelo de Mensagem Ativa

  1. Acesse o portal da Blip e selecione um chatbot que possua um número de WhatsApp ativo.

  2. Clique nos “...” no canto superior e selecione o módulo Conteúdos.

  3. Dentro da aba, escolha Modelo de Mensagens e clique em “Criar modelo”.

Uma caixa lateral será aberta para preencher as informações do modelo.
O botão “Enviar para avaliação” só ficará disponível após o preenchimento completo de todos os campos.

Campos para preenchimento

Nome do modelo

Defina o nome que identifica o template.

Use apenas letras minúsculas, números ou o caractere underline (_) para separar palavras.

Exemplo: cobranca_pedido
 

Categoria

Para mensagens de pagamento, você deve selecionar a categoria Utilidade.

 

Idioma do modelo

Selecione o idioma Português (Brasil). Atualmente, o modelo de pagamentos via WhatsApp está disponível apenas para o Brasil e Índia. Portanto, não é possível criar variações em inglês ou outros idiomas para esta finalidade específica.

 

Tipo de conteúdo da mensagem

O Blip permite diferentes formatos de conteúdo.

Mas nesse caso selecione o tipo Pagamentos. Este tipo específico habilita os campos necessários para o envio do objeto de order details (detalhes do pedido).

 

Estrutura e Interatividade do Template

Diferente dos templates comuns, as mensagens de pagamento possuem uma estrutura fixa voltada para transações.

A estrutura permite:

  • Cabeçalho: Escolha o tipo de mídia (Texto, Imagem, Documento ou Sem cabeçalho).

  • Corpo da mensagem: Insira o texto da cobrança. Você pode usar variáveis (ex: {{1}}, {{2}}) para personalizar o nome do cliente, número do pedido ou valor no texto visível.

  • Rodapé: Um texto curto e fixo ao final da mensagem.

Importante: O método de pagamento (Pix, Boleto, Cartão) não é definido nesta etapa de criação do template. Ele será configurado no arquivo de audiência (JSON) no momento do envio.

 

Envio para avaliação

Após preencher os campos e definir as variáveis do corpo da mensagem, clique em “Enviar para avaliação”.

Será exibido um modal solicitando exemplos para as variáveis. Preencha com dados fictícios que façam sentido (ex: {{1}} = Maria, {{2}} = 150,00) para que a Meta entenda o contexto.

Importante: Evite começar ou terminar o corpo da mensagem com uma variável (ex: {{1}}). O WhatsApp exige que cada variável esteja acompanhada de texto fixo antes e/ou depois, como em “Olá {{1}}, seu pedido foi enviado.” Isso ajuda o sistema a validar corretamente o conteúdo dinâmico.

Ao concluir o preenchimento, clique em “Confirmar” para finalizar o envio do modelo para análise conforme o exemplo abaixo:

Analisando o status do Message Template

Depois de enviar o seu modelo para avaliação, ele aparecerá na lista com o status “Pendente”, indicando que está em análise pela Meta.

Assim que o processo de revisão for concluído, o modelo receberá um dos seguintes status:

  • Aprovado: o template foi aceito e já pode ser utilizado nas suas campanhas.

  • Reprovado: o template foi rejeitado e não poderá ser usado.

  • Pendente: o template ainda está em análise pela Meta.

Atenção: mesmo após a aprovação, a atualização pode levar até 20 minutos para ser refletida na WhatsApp Business API.
Recomendamos que aguarde esse tempo antes de iniciar o envio da sua campanha.

 

Como enviar uma Mensagem ativa de Pagamentos via Growth

Você pode realizar o envio das mensagens de pagamento de duas formas:

  1. Via API: Para integrações sistêmicas. Consulte a documentação técnica aqui.
  2. Via Portal (Growth): Através de disparos em massa, conforme o passo a passo abaixo.

Configurando o Disparo no Growth

No portal do Blip, acesse o menu Growth → Mensagens ativas. Clique em "Enviar mensagens ativas".

A nova interface de disparo agrupa as configurações em uma tela unificada para facilitar o processo. Preencha as seções conforme a seguir:

1. Seleção do Canal

Escolha o canal WhatsApp.

2. Definição da Campanha

Defina um nome para sua campanha para facilitar a identificação nos relatórios futuros.

Caso o nome da mensagem não seja definido, ao clicar no botão “Continuar” será apresentada uma mensagem informando que não foi definido um nome e apresentando as seguintes opções:

  • Cancelar ou,
  • Continuar sem nome

Se a opção de continuar sem nome for escolhida, então um nome aleatório será definido para a mensagem.

3. Audiência (Obrigatório: Em Massa)

Para mensagens de pagamento, só é possível realizar o envio do tipo "Em massa". Opções como "Envio Individual" ou "Agente de IA" não suportam a estrutura de dados complexa (JSON) exigida para pagamentos.

Você precisará carregar um arquivo .csv contendo os dados dos clientes e as informações do pagamento.


 

Arquivo de audiência para Pagamentos

Para enviar uma mensagem de pagamentos, é preciso seguir alguns padrões específicos do arquivo de audiência, são eles:

  • Usar o delimitador ponto-e-vírgula (;) no arquivo;

  • Ter as colunas referente ao template (cabeçalho e variáveis do corpo da mensagem);

  • Finalizar com a coluna #payment#.

A coluna #payment# deve conter o objeto JSON específico da mensagem tipo “order_details” do WhatsApp.

Saiba mais sobre a mensagem de pagamentos no WhatsApp.

 

Order Details (Componente de Pedido do WhatsApp)

O template Order Details é uma nova e poderosa funcionalidade da Meta que permite às empresas enviar mensagens interativas e ricas em detalhes de pedidos (produtos, valores, status) diretamente no WhatsApp.

Essa solução abre novas fontes de receita e simplifica a jornada de pagamento, oferecendo mais credibilidade ao cliente.

Principais Usos e Benefícios:

  • Ações Otimizadas: Ideal para Cobranças Ativas, envio de Lembretes de Pagamento, Confirmação de Pedidos e Recuperação de Carrinhos Abandonados.

  • Recursos Flexíveis: Suporta até dois métodos de pagamento por mensagem, incluindo Pix Copia e Cola dinâmico, Link de Pagamento e Boleto bancário, além da opção de anexar documentos em PDF (como faturas).

  • Implementação via Blip: O envio dessas mensagens como Notificações Ativas (individuais ou em lote) é feito através da API Active Campaign da Blip. O JSON de detalhes do pedido (estrutura order_details com reference_id, total_amount, e payment_settings) é mapeado para a variável obrigatória #payment# no payload da API.

Em essência, o Order Details transforma o WhatsApp em um canal completo para fechar vendas e gerenciar transações com alta interatividade e clareza.

 

Formatando a coluna #payment#:

O formato JSON é esperado devido às inúmeras possibilidades de variação da cobrança, de acordo com cada negócio. Segue abaixo a estrutura esperada no JSON:

{
  "reference_id": "string",      // ID único do pedido (obrigatório)
  "type": "string",              // "digital-goods" ou "physical-goods" (obrigatório)
  "payment_type": "br",          // Tipo de pagamento para Brasil (obrigatório)
  "currency": "BRL",             // Moeda (obrigatório)
  "total_amount": {              // Valor total (obrigatório)
    "value": 15000,              // Valor em centavos
    "offset": 100                // Offset para casas decimais
  },
  "payment_settings": [...],     // Configurações de pagamento (obrigatório)
  "order": {                     // Detalhes do pedido (obrigatório)
    "status": "pending",
    "subtotal": {...},
    "tax": {...},
    "shipping": {...},
    "discount": {...},
    "items": [...]
  }
}

Este JSON deverá ser inserido em cada contato da sua audiência, preenchendo com os detalhes da cobrança específica deste contato.
 

Segue um exemplo prático de como seria um arquivo de audiência com 2 contatos recebendo a mensagem de cobrança contendo 3 variáveis no corpo da mensagem:

telefone;nome;fatura;vencimento;#payment#
5511111111111;Gabriel;123456;06/08;{"reference_id":"1234567","type":"digital-goods","payment_type":"br","payment_settings":[{"type":"pix_dynamic_code","pix_dynamic_code":{"code":"00020126580014BR.GOV.BCB.PIX0136dda1eb4e-744f-4453-8074-a0ab5ffed3d85204000053039865802BR5921Empresa6009SAO PAULO62140510sF9EEKoAp56304AB67","merchant_name":"Blip","key":"contato@blip.ai","key_type":"EMAIL"}}],"currency":"BRL","total_amount":{"value":200,"offset":100},"order":{"status":"pending","tax":{"value":0,"offset":100},"items":[{"retailer_id":"1234567","name":"Blippinho","amount":{"value":200,"offset":100},"quantity":1}],"subtotal":{"value":200,"offset":100}}}
5555555555555;Felipe;987654;06/08;{"reference_id":"987654","type":"digital-goods","payment_type":"br","payment_settings":[{"type":"boleto","boleto":{"digitable_line":"03399026944140000002628346101018898510000008848"}}],"currency":"BRL","total_amount":{"value":200,"offset":100},"order":{"status":"pending","tax":{"value":0,"offset":100},"items":[{"retailer_id":"1234567","name":"Blippinho","amount":{"value":200,"offset":100},"quantity":1}],"subtotal":{"value":200,"offset":100}}}


 Com este exemplo, o contato receberá a seguinte mensagem:


 

Modelo com PDF no cabeçalho

Se o seu template possui um cabeçalho em PDF, para enviar é necessário ter o link direto do arquivo (aquele onde a url termina com .pdf) e inserir obrigatoriamente na segunda coluna do arquivo de audiência. Seguindo o mesmo exemplo acima, o arquivo de audiência ficaria da seguinte maneira:

 

telefone;pdf;nome;fatura;vencimento;#payment#
5511111111111;https://conasems-ava-prod.s3.sa-east-1.amazonaws.com/aulas/ava/dummy-1641923583.pdf;Gabriel;123456;06/08;{"reference_id":"1234567","type":"digital-goods","payment_type":"br","payment_settings":[{"type":"pix_dynamic_code","pix_dynamic_code":{"code":"00020126580014BR.GOV.BCB.PIX0136dda1eb4e-744f-4453-8074-a0ab5ffed3d85204000053039865802BR5921Empresa6009SAO PAULO62140510sF9EEKoAp56304AB67","merchant_name":"Blip","key":"contato@blip.ai","key_type":"EMAIL"}}],"currency":"BRL","total_amount":{"value":200,"offset":100},"order":{"status":"pending","tax":{"value":0,"offset":100},"items":[{"retailer_id":"1234567","name":"Blippinho","amount":{"value":200,"offset":100},"quantity":1}],"subtotal":{"value":200,"offset":100}}}

Com este exemplo, o contato receberá a seguinte mensagem:


 

Modelo

A etapa de Modelo, é onde a mensagem desejada é escolhida e respeita a formatação, inclusive a quantidade de parâmetros, caso existam.

WhatsApp

Seleção obrigatória de categoria da mensagem

A primeira ação do usuário deve ser selecionar a categoria da mensagem que deseja enviar: Marketing, Utilidade ou Autenticação, essa ação é obrigatória. Somente após essa seleção o campo de escolha de template será habilitado, exibindo apenas os templates compatíveis com a categoria escolhida.

Atenção! Apenas modelos de mensagem aprovados pela Meta estarão disponíveis para serem enviados.

  • Após a seleção do Message Template uma prévia da mensagem será carregada à direita da tela. 

Caso seja um envio em massa, o arquivo que você carregou no passo anterior será comparado ao modelo de mensagem que você selecionou, cruzando os dados para verificar se os campos da planilha e das variáveis são compatíveis entre si (ou seja, existe no arquivo o número de colunas adequadas as variáveis a serem substituídas neste modelo de mensagem). 

Se qualquer divergência for identificada, você receberá um alerta

 

Direcionamento

Na etapa de Direcionamento você deverá selecionar o tipo de direcionamento, o bot atrelado e a etapa do fluxo para o qual o contato será direcionado.

Router

Caso o chatbot seja do tipo Builder, basta selecionar o tipo de direcionamento e o fluxo para o qual o redirecionamento será feito.

Para o redirecionamento funcionar na estrutura de bots roteadores, a configuração de contexto do roteador deve estar ligada.

O envio em massa não permite selecionar atendentes para o envio. Eles serão enviados para a fila default.

Builder

Agora basta clicar em continuar e seguir para a próxima etapa.

 

Resumo e Envio

Nesta etapa você deverá conferir se os valores das etapas anteriores estão corretos. Caso exista alguma inconsistência, clique no ícone de edição relativo à etapa com inconsistências e você será redirecionado para a etapa selecionada para fazer os ajustes.

Resumo

Estando tudo correto, você poderá escolher entre enviar campanha agora ou agendar o envio para um horário futuro.

Usando a opção Enviar agora, basta clicar no botão Enviar mensagens ativas e a campanha será enviada aos contatos.

Caso tenha escolhido a opção Agendar envio, selecione a data e o horário e clique em Agendar mensagens ativas para programar o envio da sua campanha.

Opções de agendamento

Atenção! A política de envio de mensagens Ativas do WhatsApp inclui a possibilidade de pausar e desativar Message Templates quando estes apresentam problemas, especialmente relacionados a bloqueios e denúncias dos seus clientes.

Campanhas agendadas poderão verificar falhas caso o Message Template escolhido esteja temporariamente indisponível no momento agendado para envio.



Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃

Artigos relacionados