Somente os usuários planos personalizados podem se integrar com o Webhook. Se você está interessado na integração do Webhook, entre em contato com a equipe de vendas da Cooby.

Neste guia, você conectará o WhatsApp ao seu destino usando Cooby custom Webhooks.

Você pode usar o mesmo Webhook para os 2 gatilhos de eventos diferentes, ou configurar Webhooks separados para cada gatilho de evento.

Configurar guia

Este guia usa o webhook.site como um exemplo

Vá para o seu espaço de trabalho centro de integração
Encontre Webhook personalizado e clique em Guia de Integração.
Crie um ponto de extremidade Webhook no destino desejado.
1. Lembre-se de marcar Cabeçalhos CORS como verificada
Cole a URL do Webhook nas ações Disparar quando receber as mensagens do WhatsApp no guia de integração do Cooby, em seguida, clique Salvar.
1. Caso queira acionar uma ação ao enviar uma mensagem do WhatsApp. cole sua URL do Webhook em Ações para acionar quando enviar mensagens do WhatsApp.
Certifique-se de ver a URL do Webhook salva, indicando um salvamento bem-sucedido.
Volte para a página anterior e clique em Gerenciar Permissões para o campo Webhook personalizado.
Ativar a permissão personalizada de Webhook para aqueles que ativarem eventos de Webhook quando receberem mensagens de WhatsApp.
Para garantir que a integração do Webhook seja configurada corretamente, lembre-se de atualizar tanto a sua WhatsApp Web como o WhatsApp Web dos membros da sua equipe após alterar as configurações.
1. All users in the team who have integration permission will see the Grant Access to Cooby popup the next time they open or refresh WAW.
Uma vez que você tenha recebido o payload, você pode usá-lo para configurar várias ações.

Formato de carga

{
  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;
  };
}

Carga de exemplo

{
  chat_id: "[email protected]";
  chat_type: "individual";
  chat_title: "Sarah Brown";
  user_phone: "447441368384";
  user_email: "[email protected]";
  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";
  };
}

Saiba mais sobre as definições de cada coluna

Saiba mais sobre a frequência de sincronização da integração do Webhook

Saiba mais sobre o mecanismo de sincronização de integração do Webhook

Saiba mais sobre como sincronizar mensagens históricas na integração de webhook

Esperamos que este documento lhe ajude a entender melhor como o Cooby funciona. Para quaisquer preocupações ou perguntas sobre a integração do seu Webhook personalizado, envie um e-mail para [email protected]💜