Sign inGet Started

Conectores de webhook

Um conector entrega cada evento como a solicitação que a plataforma dele espera, em vez de enviar o evento bruto para uma URL hospedada por você. Configure um no painel, com bird webhooks create --connector <id> ou com destination.connector em Criar um webhook. Bird monta a URL do endpoint a partir do conector e dos campos dele, então o endpoint não recebe um url próprio.

Os campos não secretos vão em config e os campos secretos em credentials. Os valores secretos são somente de gravação: nenhuma resposta os inclui. Uma criação que não informa um campo exigido pelo conector, ou que informa um campo que ele não aceita, é recusada com a indicação dos campos do conector. Para um passo a passo, consulte Encaminhe mensagens para seu agente de IA.

Claude Managed Agents

Envie cada mensagem que você recebe para seu agente gerenciado do Claude. O ID dele é claude_managed_agents.

Ele aceita whatsapp.received, sms.received, email_mailbox.message_received e amb.received.

CampoVai emObrigatórioDescrição
agent_idconfigSimRetornado quando você cria o agente. As sessões usam a versão mais recente dele.
environment_idconfigSimRetornado quando você cria o ambiente.
vault_idconfigNãoUm cofre de credenciais que o agente usa, como o que guarda a credencial Bird MCP dele, para que ele possa responder pelo Bird.
api_keycredentialsSimDo espaço de trabalho do Claude em que seu agente é executado.

Antes de conectá-lo, faça o seguinte na plataforma:

  1. Primeiro, configure seu agente no Claude. No Claude Console, crie o agente, o ambiente dele e uma chave API no mesmo espaço de trabalho. Depois, informe os IDs e a chave em Bird. Consulte platform.claude.com.
  2. Crie uma chave API. Faça isso no espaço de trabalho do Claude em que seu agente é executado. Consulte platform.claude.com.
  3. Copie os IDs do agente e do ambiente. Cada criação retorna o respectivo ID. Consulte platform.claude.com.
  4. Opcionalmente, adicione um cofre de credenciais. Para que o agente possa responder por meio de Bird, armazene a credencial Bird MCP dele em um cofre de credenciais do Claude e informe aqui o ID do cofre. Cada sessão recebe esse cofre. Consulte platform.claude.com.

Grok Bot

Envie cada mensagem recebida para uma rotina do Grok Bot. O ID dele é grok_bot.

Ele aceita whatsapp.received, sms.received, email_mailbox.message_received e amb.received.

CampoVai emObrigatórioDescrição
webhook_urlconfigSimA URL de webhook da rotina.
sender_keycredentialsSimA chave de remetente da rotina. O Bird a envia apenas como token Bearer.

Antes de conectá-lo, faça o seguinte na plataforma:

  1. Primeiro, peça ao Grok Bot para criar uma rotina. Peça ao Grok Bot para criar uma rotina com um gatilho de webhook e, em seguida, insira em Bird a URL do webhook e a chave do remetente que ele fornecer. Consulte cursor.com.