Mensagem Ativa de Pagamento no WhatsApp

Contexto

• O componente "order_details" é um novo tipo de funcionalidade de pagamento disponibilizado pela Meta para o WhatsApp.

• Ele permite que sua empresa envie aos clientes mensagens interativas, ativas ou durante o fluxo, com detalhes de pedidos e opções de pagamento diretamente no aplicativo.

• Já é possível realizar o envio deste componente de forma ativa por meio da API Active Campaign da Blip.

Benefícios para sua empresa

🔹Nova fonte de receita: Abre potencial para novas fontes de receita aplicadas a diversos casos de uso como vendas e cobrança.

🔹Jornada facilitada: Simplifica a experiência de pagamentos para seus clientes e com mais credibilidade.

🔹Experiência aprimorada: Oferece uma nova e rica experiência para vendas e cobranças, com informações detalhadas de transações (produtos, valores, status) de forma interativa.

Casos de uso

O componente order_details é ideal para otimizar diversos fluxos de comunicação e transação no WhatsApp:

🔹Cobranças e lembretes de pagamento: Envie cobranças diretas com opções de pagamento (Pix, link ou boleto) e anexo de fatura em PDF.

🔹Confirmação de pedidos: Envie um resumo do pedido com valor total e detalhes dos itens após uma compra para pagamento.

🔹Carrinho abandonado: Informe ao cliente sobre o status do pedido (ex: "pendente") e inclua detalhes de pagamento com este template.

🔹Renovação de assinaturas/serviços: Facilite o pagamento de renovações com todas as informações necessárias.

🔹Vendas diretas no atendimento: Permita que seus atendentes ou bots apresentem uma "cesta" de produtos e opções de pagamento de forma clara e interativa.

Recursos suportados

Este componente oferece flexibilidade para a inclusão de diferentes métodos de pagamento e informações adicionais:

🔹Métodos de pagamento

• Pix dinâmico: Envie um código Pix Copia e Cola que o cliente pode copiar para realizar o pagamento instantaneamente.
• Link de pagamento: Direcione o cliente para uma URL segura para finalizar o pagamento, como no caso de pagamentos com cartão de crédito e wallets.
• Boleto bancário: Forneça o código de barras do boleto para que o cliente possa efetuar o pagamento.

🔹Anexo de Documentos (Opcional): Você pode incluir um arquivo PDF (como um boleto, fatura ou comprovante) no cabeçalho da mensagem do template.

🔹Flexibilidade de Conteúdo: A API Blip permite o envio do componente desde que pelo menos um dos itens de pagamento (Pix, Link, Boleto) e no máximo 2 itens, estejam presentes.

🔹Ícones de Pagamento: Os ícones correspondentes aos métodos de pagamento (ícone do Pix, bandeiras de cartões, etc.) são exibidos conforme os métodos configurados.

Guia de Implementação

A funcionalidade de envio de mensagens com o template order_details é realizada através da API de Active Campaign da Blip, permitindo que estas mensagens sejam enviadas como Notificações Ativas.

🔹Tipos de envio suportados

• Individual: Para enviar o componente de pedido para um único destinatário.
• Em Lote (Batch/Massa): Para enviar o componente de pedido para múltiplos destinatários de uma vez.

🔹Estrutura da mensagem (Payload)

• Para enviar o order_details como um template, você deve fazer uma chamada POST para o endpoint de mensagens do WhatsApp e anexar um objeto de mensagem com type=template.
• Variável #payment#: Mesmo que seu template order_details não possua outras variáveis, é obrigatório passar a variável #payment# no objeto audience.messageParams. Esta variável contém diretamente o JSON completo do objeto order_details.
• Estrutura básica do JSON #payment# (Order Details):
  • reference_id: Um ID único para o pedido (obrigatório).
  • type: "digital-goods" (produtos digitais) ou "physical-goods" (produtos físicos) (obrigatório).
  • payment_type: "br" (para pagamentos no Brasil) (obrigatório).
  • currency: "BRL" (Moeda) (obrigatório).
  • total_amount: Objeto contendo o value (valor total em centavos) e offset (normalmente 100 para 2 casas decimais, ex: R$ 150,00 = value: 15000, offset: 100) (obrigatório).
  • payment_settings: Uma lista de objetos com as configurações dos métodos de pagamento.
  • order: (obrigatório) Objeto com detalhes do pedido como status, subtotal, tax, shipping, discount e items.
• Configurações específicas para payment_settings:
  • Pix dinâmico
  • Link de pagamento
  • Boleto:
• Estrutura de Itens do Pedido (Dentro do objeto order)

🔹Anexo PDF no cabeçalho

• Para incluir um PDF, use type=document no objeto parameter do componente header da mensagem do template. A API Blip permite o envio de PDF de boleto/fatura.

🔹Validações importantes

• Todas as URLs de pagamento devem usar HTTPS.
• Códigos de boleto e Pix devem seguir os formatos válidos (linha digitável e padrão BR Code, respectivamente).
• Todos os campos obrigatórios na estrutura do JSON devem ser fornecidos.
• O template order_details deve estar previamente aprovado no WhatsApp Business Manager.

🔹Campos message.messageParams e audience.messageParams

• O campo message.messageParams (na configuração geral da mensagem) deve conter apenas os nomes das variáveis que o template espera (ex: "cliente_nome", "pedido_numero", "valor_total", "#payment#").
• Os valores dessas variáveis, incluindo o JSON completo do order_details para #payment#, devem ser preenchidos no audience.messageParams (para cada destinatário ou audiência).

🔹Método para envio

• O envio é realizado através do método CreateAndDispatchFullCampaignAsync, acessível via o endpoint POST /campaigns/full-campaign na API da Blip.

Pontos de atenção

🔹É necessário configurar pelo menos um método de pagamento.

🔹É possível configurar até 2 métodos de pagamento diferentes no mesmo template.

🔹É necessário criar os templates no WhatsApp Business Manager e que eles estejam aprovados.

🔹A seguir, exemplos de combinações de métodos de pagamento:

Referências e Suporte

🔹Documentação Oficial da Meta para Order Details: consulte ara entender os padrões e estruturas do WhatsApp.

🔹Documentação da Blip: Para mais detalhes sobre a API de Active Campaign, o endpoint CreateAndDispatchFullCampaignAsync e exemplos de uso em suas integrações, consulte a documentação oficial da Blip (especialmente as seções sobre Mensagens Ativas e Campanhas).

🔹Suporte Blip: Em caso de dúvidas ou necessidade de suporte técnico para a implementação, entre em contato com a equipe de suporte da Blip.