Webhooks de grupo WhatsApp

Dois eventos de webhook reportam atividade de solicitação de entrada em um grupo que exige aprovação. Ambos são ações do próprio solicitante, então nenhum aparece na resposta a qualquer chamada que você faz, e uma solicitação criada e cancelada entre duas leituras da lista não deixa rastro. Assine esses eventos e você não precisa fazer polling.

Evento	Dispara quando
whatsapp.group.join_request_created	Alguém abre o link de convite e solicita participar
whatsapp.group.join_request_revoked	A pessoa cancela essa solicitação antes de você decidir

Decidir uma solicitação não dispara nenhum evento, porque o resultado já está na resposta da sua própria chamada. Nenhum dos eventos faz parte da linha do tempo de uma mensagem.

Solicitação de entrada criada

Exemplo de código

{
  "type": "whatsapp.group.join_request_created",
  "timestamp": "2026-09-22T10:07:57Z",
  "data": {
    "group_id": "wag_01krdgeqd0abc5s7t44vh8rt9mg",
    "whatsapp_number_id": "wan_01krdgeqd1def5s7t44vh8rt9mg",
    "workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
    "join_request": {
      "id": "wgj_01krdgeqcxet5s7t44vh8rt9mg",
      "bsuid": "US.1566655121691972",
      "phone_number": "+13124495648",
      "username": "john.doe"
    }
  }
}

timestamp é quando a pessoa solicitou a entrada.

Solicitação de entrada revogada

Exemplo de código

{
  "type": "whatsapp.group.join_request_revoked",
  "timestamp": "2026-09-22T11:12:03Z",
  "data": {
    "group_id": "wag_01krdgeqd0abc5s7t44vh8rt9mg",
    "whatsapp_number_id": "wan_01krdgeqd1def5s7t44vh8rt9mg",
    "workspace_id": "ws_01krdgeqcxet5s7t44vh8rt9mg",
    "join_request": {
      "id": "wgj_01krdgeqcxet5s7t44vh8rt9mg",
      "bsuid": "US.1566655121691972",
      "phone_number": "+13124495648",
      "username": "john.doe"
    }
  }
}

O data é o mesmo da solicitação que ele cancela, com o mesmo join_request.id. timestamp é quando a solicitação foi cancelada.

Campos

Campo	Significado
group_id	O grupo ao qual a pessoa solicitou participar
whatsapp_number_id	O número comercial que criou e administra o grupo
workspace_id	O espaço de trabalho que possui o grupo
join_request.id	A solicitação. O mesmo ID que a lista de solicitações de entrada retorna e que as operações em lote de aprovação e rejeição recebem, para que você possa decidir diretamente a partir do evento
join_request.bsuid	O ID de usuário com escopo de negócio do solicitante. Toda solicitação inclui esse ID, e ele é transferido para participants se você aprovar, então use-o como chave nos seus próprios registros
join_request.phone_number	O número do solicitante no formato E.164, ou null se ele não o compartilhou com o seu negócio
join_request.username	O nome de usuário WhatsApp do solicitante, ou null se ele não escolheu um

Próximos passos

Gerenciando grupos WhatsApp: aprovar ou rejeitar uma solicitação
Webhooks WhatsApp: os outros eventos que você pode assinar
Guia de webhooks: endpoints, verificação de assinatura e tentativas de reenvio

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaConnecting WhatsApp to Bird: from buying a number to a live channel Entenda o conceitoWhat is the 24-hour customer service window on WhatsApp?Use a ferramentaWhatsApp message builder Explore a funcionalidadeWhatsApp

Experimente na prática e obtenha um resumo de implementação