Pular para o conteúdo principal

Integração WhatsApp

integrao-whatsapp

A integração WhatsApp permite automatizar comunicações através da API oficial do WhatsApp Business, enviando mensagens, recebendo notificações e gerenciando conversas de forma programática.

o que voc encontrar​

aqui

Esta documentação abrange:

  • Configuração da API: Como configurar o WhatsApp Business API
  • Envio de mensagens: Diferentes tipos de mensagens suportadas
  • Recebimento de mensagens: Webhooks e notificações
  • Automações comuns: Workflows típicos de WhatsApp
  • Conformidade: Regras e boas práticas

conceitos​

fundamentais

whatsapp business api​

A API oficial do WhatsApp Business permite:

  • Envio de mensagens: Texto, mídia, documentos
  • Recebimento de mensagens: Webhooks em tempo real
  • Gestão de conversas: Status e histórico
  • Automação: Integração com sistemas

tipos de mensagens​

  1. Mensagens de Texto: Conteúdo textual simples
  2. Mensagens de Mídia: Imagens, áudios, vídeos
  3. Mensagens de Documento: PDFs, planilhas
  4. Mensagens de Localização: Coordenadas geográficas
  5. Mensagens de Contato: Compartilhar contatos

configurao​

bsica

pr requisitos​

  1. Conta WhatsApp Business: Aprovada pelo WhatsApp
  2. Número de Telefone: Verificado e ativo
  3. Token de Acesso: Gerado na plataforma Meta
  4. Webhook URL: Endpoint para receber notificações

configurao de credenciais​

{
  "accessToken": "seu_token_aqui",
  "phoneNumberId": "seu_phone_number_id",
  "businessAccountId": "seu_business_account_id",
  "webhookVerifyToken": "token_verificacao_webhook"
}

casos de uso​

comuns

id​

1-notificaes-automticas

id​

2-atendimento-ao-cliente

id​

3-campanhas-de-marketing

workflows​

prticos

workflow confirmao de pedido​

  1. Trigger: Novo pedido no sistema
  2. Validação: Verificar dados do cliente
  3. Envio: WhatsApp com confirmação
  4. Acompanhamento: Status de entrega
  5. Feedback: Solicitar avaliação

workflow suporte ao cliente​

  1. Recebimento: Mensagem do cliente
  2. Análise: Classificar tipo de suporte
  3. Roteamento: Direcionar para setor correto
  4. Resposta: Enviar solução ou agendamento
  5. Follow-up: Acompanhar resolução

configurao de​

webhooks

endpoint de recebimento​

// Exemplo de webhook para receber mensagens
{
  "method": "POST",
  "url": "https://seu-dominio.com/webhook/whatsapp",
  "headers": {
    "Content-Type": "application/json"
  },
  "body": {
    "object": "whatsapp_business_account",
    "entry": [
      {
        "id": "phone_number_id",
        "changes": [
          {
            "value": {
              "messaging_product": "whatsapp",
              "messages": [...]
            }
          }
        ]
      }
    ]
  }
}

boas​

prticas

conformidade horrio de​

envio

  • Respeitar horário comercial
  • Consentimento: Obter permissão do cliente
  • Opt-out: Permitir cancelamento fácil
  • Conteúdo: Evitar spam e conteúdo inadequado

performance rate limiting​

  • Respeitar limites da API
  • Retry Logic: Implementar retry em caso de falha
  • Monitoramento: Acompanhar métricas de entrega
  • Logs: Registrar todas as interações

prximos passos​

recursos relacionados​