📱

Meta WhatsApp Integration

HRNET Telecom - Webhook Service

Última atualização: 11 de novembro de 2025

✅ Status do Serviço: Operacional
🌐 Endpoint: https://hrnotify.hr-net.app.br/api/v1/webhook/meta
📡 Versão da API: v21.0

1. Sobre o Serviço

Este serviço fornece integração com a API oficial do WhatsApp Business da Meta, permitindo receber e processar mensagens através de webhooks. O sistema está configurado para receber notificações em tempo real e responder automaticamente quando necessário.

2. Endpoints Disponíveis

GET /api/v1/webhook/meta

Descrição: Endpoint de verificação do webhook

Parâmetros:

hub.mode - Deve ser "subscribe"
hub.verify_token - Token de verificação configurado
hub.challenge - String aleatória fornecida pela Meta

Resposta: Retorna o hub.challenge se o token estiver correto

POST /api/v1/webhook/meta

Descrição: Endpoint para receber webhooks da Meta

Autenticação: Bearer Token (opcional, mas recomendado)

Headers:

X-Hub-Signature-256 - Assinatura HMAC-SHA256 (validada se APP_SECRET configurado)
Authorization: Bearer {token} - Token de autenticação

Resposta: {"status": "ok", "message": "Webhook received"}

3. Estrutura do Webhook

O webhook recebe dados no seguinte formato:

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "...",
              "phone_number_id": "..."
            },
            "messages": [...],
            "statuses": [...]
          }
        }
      ]
    }
  ]
}
            

4. Tipos de Mensagens Suportadas

Tipo	Descrição	Status
`text`	Mensagens de texto	✅ Suportado
`image`	Imagens com legenda opcional	✅ Suportado
`video`	Vídeos com legenda opcional	✅ Suportado
`audio`	Mensagens de áudio	✅ Suportado
`document`	Documentos com legenda opcional	✅ Suportado
`sticker`	Figurinhas	✅ Suportado

5. Funcionalidades

Validação de Assinatura: Validação HMAC-SHA256 usando APP_SECRET
Autenticação: Suporte a Bearer Token (JWT ou Webhook Token)
Echo Automático: Resposta automática para mensagens de texto (configurável)
Processamento de Status: Monitoramento de status de entrega das mensagens
Logging Detalhado: Registro completo de todas as interações

6. Segurança

Medidas de Segurança Implementadas:

Validação de assinatura HMAC-SHA256
Autenticação via Bearer Token
HTTPS obrigatório (SSL/TLS)
Logging de todas as requisições
Validação de estrutura de dados

7. Monitoramento

O sistema registra todas as interações em logs detalhados, incluindo:

Recepção de webhooks
Validação de assinaturas
Processamento de mensagens
Envio de respostas
Erros e exceções

8. Limitações

O serviço está sujeito às limitações da API oficial do WhatsApp Business
Janela de 24 horas para envio de mensagens sem template
Rate limiting conforme políticas da Meta
Disponibilidade sujeita a manutenções programadas

9. Suporte

Para questões técnicas ou suporte relacionado à integração Meta WhatsApp:

HRNET Telecom
Email: contato@hr-net.app.br
Telefone: (19) 3561-8282
Website: https://hr-net.app.br