---
title: "Conectores de webhook"
description: "Todas as plataformas pelas quais um endpoint de webhook pode entregar eventos: os campos de cada uma, os eventos que ela aceita e a configuração que você precisa fazer antes na plataforma."
canonical: "https://bird.com/pt-br/documentacao/ai/webhook-connectors"
---

<!-- Code generated by beak gen:webhook-connectors from the connector definitions; DO NOT EDIT. -->

# 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](https://bird.com/dashboard/w/webhooks/new), com `bird webhooks create --connector <id>` ou com `destination.connector` em [Criar um webhook](/docs/api/reference/create-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](/docs/ai/route-messages-to-an-agent).

## 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`.

| Campo            | Vai em        | Obrigatório | Descrição                                                                                                                       |
| ---------------- | ------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
| `agent_id`       | `config`      | Sim         | Retornado quando você cria o agente. As sessões usam a versão mais recente dele.                                                |
| `environment_id` | `config`      | Sim         | Retornado quando você cria o ambiente.                                                                                          |
| `vault_id`       | `config`      | Não         | Um cofre de credenciais que o agente usa, como o que guarda a credencial Bird MCP dele, para que ele possa responder pelo Bird. |
| `api_key`        | `credentials` | Sim         | Do 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](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
2. **Crie uma chave API.** Faça isso no espaço de trabalho do Claude em que seu agente é executado. Consulte [platform.claude.com](https://platform.claude.com/settings/keys).
3. **Copie os IDs do agente e do ambiente.** Cada criação retorna o respectivo ID. Consulte [platform.claude.com](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session).
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](https://platform.claude.com/docs/en/managed-agents/vaults).

## 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`.

| Campo         | Vai em        | Obrigatório | Descrição                                                                |
| ------------- | ------------- | ----------- | ------------------------------------------------------------------------ |
| `webhook_url` | `config`      | Sim         | A URL de webhook da rotina.                                              |
| `sender_key`  | `credentials` | Sim         | A 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](https://cursor.com/help/grok-bot/routines#where-do-the-webhook-url-and-key-live-and-what-does-a-200-mean).

## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [What is an MCP server, and how does an agent use one to send messages?](/explained/platform/what-is-an-mcp-server-and-how-does-an-agent-send-messages) (answer)
- [Coding agents](/ai) (product)
- [Build with AI agents](/learn/paths/agents) (course)

[Get an implementation brief](/learn/workspace?topic=agents)