Pular para o conteúdo principal

Integração 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

Configuração Básica​

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

Configuração de Credenciais​

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

Casos de Uso Comuns​

1. Notificações Automáticas​

2. Atendimento ao Cliente​

3. Campanhas de Marketing​

Workflows Práticos​

Workflow: Confirmação 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

Configuração 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 Práticas​

Conformidade​

  • Horário 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

Próximos Passos​

Recursos Relacionados​