Webhooks de grupos de WhatsApp

Dos eventos de webhook informan sobre la actividad de solicitudes de unión en un grupo que requiere aprobación. Ambos son acción del propio solicitante, así que ninguno aparece en la respuesta a las llamadas que tú hagas, y una solicitud creada y cancelada entre dos lecturas de la lista no deja rastro. Suscríbete a ellos y no tendrás que hacer polling.

Evento	Se dispara cuando
whatsapp.group.join_request_created	Alguien abre el enlace de invitación y solicita unirse
whatsapp.group.join_request_revoked	Cancela esa solicitud antes de que tú la resuelvas

Resolver una solicitud no dispara ningún evento, porque el resultado ya está en la respuesta a tu propia llamada. Ninguno de los dos eventos forma parte de la línea temporal de un mensaje.

Solicitud de unión creada

Ejemplo 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 es el momento en que la persona solicitó unirse.

Solicitud de unión revocada

Ejemplo 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"
    }
  }
}

El data es el mismo que el de la solicitud que cancela, con el mismo join_request.id. timestamp es el momento en que se canceló la solicitud.

Campos

Campo	Significado
group_id	El grupo al que la persona solicitó unirse
whatsapp_number_id	El número de negocio que creó y administra el grupo
workspace_id	El espacio de trabajo propietario del grupo
join_request.id	La solicitud. El mismo ID que devuelve la lista de solicitudes de unión y que aceptan las operaciones de aprobación y rechazo por lotes, así que puedes resolver directamente desde el evento
join_request.bsuid	El ID de usuario con alcance de negocio del solicitante. Todas las solicitudes lo incluyen y se mantiene en participants si apruebas, así que úsalo como clave en tus propios registros
join_request.phone_number	El número del solicitante en formato E.164, o null si no lo ha compartido con tu negocio
join_request.username	El nombre de usuario de WhatsApp del solicitante, o null si no ha elegido uno

Próximos pasos

Gestión de grupos de WhatsApp: aprobar o rechazar una solicitud
Webhooks de WhatsApp: los demás eventos a los que puedes suscribirte
Guía de webhooks: endpoints, verificación de firma y reintentos

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaConnecting WhatsApp to Bird: from buying a number to a live channel Comprender el conceptoWhat is the 24-hour customer service window on WhatsApp?Usar la herramientaWhatsApp message builder Explorar la funcionalidadWhatsApp

Prueba el ejercicio y obtén un resumen de implementación