Guía de integración de Webhook personalizado

En esta guía, conectarás WhatsApp con tu destino utilizando Webhooks personalizados de Cooby.

Puedes usar el mismo Webhook para los dos diferentes disparadores de eventos, o configurar Webhooks separados para cada disparador de evento.

Guía de configuración

1. Ve al centro de integraciones de tu espacio de trabajo
2. Busca Webhook personalizado y haz clic en Guía de integración.

3. Crea un endpoint de Webhook en tu destino deseado.

• Recuerda marcar la opción CORS Headers como seleccionada.

4. Pega la URL del Webhook en el campo Trigger actions when receiving WhatsApp messages en la guía de integración de Cooby, luego haz clic en Save.

• Si deseas activar una acción al enviar un mensaje de WhatsApp, pega la URL del Webhook en Trigger actions when sending WhatsApp messages.

5. Asegúrate de ver la URL del Webhook guardada, lo que indica que se ha guardado correctamente.

Haz clic en la página anterior y luego en Administrar Permisos para el campo Webhook Personalizado.

7. Activa el permiso de Webhook personalizado para aquellos que activarán eventos de Webhook al recibir mensajes de WhatsApp.

8. Para asegurarte de que la integración de Webhook esté configurada correctamente, recuerda actualizar tanto tu WhatsApp Web como el de los miembros de tu equipo después de realizar cualquier cambio en la configuración.

• Todos los usuarios del equipo que tengan permiso de integración verán la ventana emergente Conceder acceso a Cooby la próxima vez que abran o actualicen WhatsApp Web.

9. Una vez que hayas recibido el payload, puedes usarlo para configurar varias acciones.

Formato de carga útil (Payload Format)

{
  chat_id: string;
  chat_type: "group" | "individual";
  chat_title: string;
  user_phone: string;
  user_email: string;
  direction: "sent" | "received";
  message: {
    id: string;
    type: "call_log" | "chat" | "location" | "payment" | "vcard" | "ciphertext" | "multi_vcard" | "revoked" | "oversized" |   "groups_v4_invite" | "template_button_reply" | "debug" | "image" | "video" | "audio" | "sticker" | "status_v3" | "document" | "product" | "order" | "list" | "interactive" | "interactive_response" | "list_response" | "buttons_response" | "reaction" | "reaction_enc" | "poll_creation" | "request_phone_number" | "poll_update" | "native_flow" | "biz-cover-photo" | "keep_in_chat" | "pin_message" | "unknown";
    text: string;
    file_name: string | null;
    file_url: string| null;
    caption: string | null;
    is_error: boolean;
    error_code: string | null;
    error_message: string | null;
  };
  timestamp: string;
  participants: {
    phone: string;
    wa_name: string;
  }[];
  sender: {
    phone: string;
    wa_name: string;
  };
}

Ejemplo de payload

{
  chat_id: "447441369136_447441368384@c.us";
  chat_type: "individual";
  chat_title: "Sarah Brown";
  user_phone: "447441368384";
  user_email: "support@cooby.co";
  direction: "sent";
  message: {
    id: "3EB093D273669B3BE3D2";
    type: "chat";
    text: "Hi, welcome to Cooby!";
    file_name: "Cooby Image 2023-07-12 at 11.13.32 AM";
    file_url: "https://api.cooby.co/v2/files/xxxxx";
    caption: "Hi, welcome to Cooby!";
    is_error: false;
    error_code: null;
    error_message: null;
  };
  timestamp: "1628843453";
  participants: [
   {
    phone: "447441369136";
    wa_name: "Sarah Brown";
   },
   { 
    phone: "447441368384", 
    wa_name: "Cooby" 
   } 
  ],
  sender: {
    phone: "447441368384";
    wa_name: "Cooby";
  };
}

Más información sobre la definición de cada columna

Más información sobre la frecuencia de sincronización de la integración de Webhook

Más información sobre el mecanismo de sincronización de la integración de Webhook

Más información sobre la sincronización de mensajes históricos en la integración de Webhook

Esperamos que este documento te ayude a comprender mejor cómo funciona Cooby. Si tienes alguna duda o pregunta sobre tu integración de Webhook personalizado, por favor envíanos un correo a support@cooby.co 💜

Actualizado el: 18/06/2025