# Encaminhe mensagens para seu agente de IA

Bird envia cada mensagem que você recebe por WhatsApp, SMS, Apple Messages ou uma caixa de correio de agente para seu agente de IA. Conecte o agente uma vez com seus dados e credenciais, e cada nova mensagem chegará até ele.

Dois agentes são suportados:

- **Claude Managed Agents**: cada mensagem inicia uma sessão de um agente que você criou no Claude Console.
- **Grok Bot**: cada mensagem aciona uma das suas rotinas do Grok Bot.

Bird envia cada mensagem correspondente para seu agente e tenta novamente uma entrega que falhar, então uma mensagem reenviada pode iniciar outra execução. O agente recebe o JSON do evento da mensagem, o mesmo payload que um [endpoint de webhook](/docs/guides/webhooks) comum recebe, e responde por meio das ferramentas que você disponibilizou, como o [servidor Bird MCP](/docs/ai/mcp-server).

## Escolha as mensagens que seu agente responde

Seu agente pode responder apenas mensagens recebidas: `whatsapp.received`, `sms.received`, `amb.received` (Apple Messages) e `email_mailbox.message_received`. Selecione as que o agente deve tratar. Confirmações de entrega, mudanças de status e outros eventos não são enviados para um agente.

## Claude Managed Agents

Primeiro, configure seu agente no [Claude Console](https://platform.claude.com/docs/en/managed-agents/quickstart#create-your-first-session): crie o agente e seu ambiente, e uma [chave API](https://platform.claude.com/settings/keys) no mesmo espaço de trabalho. Anote o ID do agente e o ID do ambiente. Novas sessões usam a versão mais recente do agente.

Em seguida, conecte-o no Bird:

1. [Crie um webhook](https://bird.com/dashboard/w/webhooks/new) e escolha **Claude Managed Agents**.
2. Em **Triggers**, selecione as mensagens que o Claude deve responder.
3. Em **Connect**, nomeie o webhook e insira o agent ID, o environment ID e a chave API.
4. Revise o webhook e crie-o.

Cada mensagem inicia uma sessão cujo primeiro user message é `New Bird event:` seguido do evento JSON.

## Grok Bot

Primeiro, peça ao Grok Bot para criar uma rotina com um gatilho de webhook. Ele fornece a webhook URL e a sender key da rotina. Para configurar o gatilho manualmente, consulte [Cursor's webhook triggers](https://cursor.com/docs/cloud-agent/automations#webhook-triggers).

Em seguida, conecte-o no Bird:

1. [Crie um webhook](https://bird.com/dashboard/w/webhooks/new) e escolha **Grok Bot**.
2. Em **Triggers**, selecione as mensagens que o Grok Bot deve responder.
3. Em **Connect**, nomeie o webhook e cole a webhook URL e a sender key.
4. Revise o webhook e crie-o.

Cada mensagem envia o evento JSON para a URL de webhook da rotina, com a chave do remetente como token Bearer, e a rotina executa o prompt salvo.

## Crie pela CLI ou API

`bird webhooks create --help` lista cada conector com seus campos, quais deles são secretos, os eventos que ele aceita e a configuração prévia necessária. Passe campos não secretos com `--field name=value` e cada segredo a partir de uma variável de ambiente com `--secret-env name=ENV_VAR`, ou redirecione com `--secret-stdin name`, para que ele não apareça no histórico do shell. `--events` assume como padrão todos os eventos de mensagem que o conector aceita.

Para o Claude, crie uma [chave API](https://platform.claude.com/settings/keys) no espaço de trabalho em que seu agente roda e depois leia-a na variável de ambiente sem exibi-la, para que ela nunca apareça em uma linha de comando ou no histórico do shell:

```bash
read -rs ANTHROPIC_API_KEY && export ANTHROPIC_API_KEY  # paste the key, then press Enter
bird webhooks create --connector claude_managed_agents \
  --field agent_id=agent_123 --field environment_id=env_123 \
  --secret-env api_key=ANTHROPIC_API_KEY
```

A API aceita o mesmo `destination` em [`POST /v1/webhooks`](/docs/api/reference/create-webhook). Omita `url`: Bird o constrói a partir do conector. Nenhuma resposta inclui as credenciais.

## Teste a conexão

Logo após criar o webhook, selecione **Send test**. Depois, use **Send test event** na página do webhook ou nas ações da linha, ou chame [`POST /v1/webhooks/{webhook_id}/test`](/docs/api/reference/test-webhook). Verifique no Claude ou no Cursor se uma sessão ou execução foi iniciada. Em seguida, envie uma mensagem real para um dos seus números ou canais e confirme que o agente a processou.

## Operação

- **Rotacione uma credencial.** Edite o webhook e insira apenas o novo valor; um campo deixado em branco mantém o valor armazenado. Pela API, envie a chave alterada em [`PATCH /v1/webhooks/{webhook_id}`](/docs/api/reference/update-webhook) `credentials`. A próxima entrega já a utiliza, incluindo novas tentativas.
- **Aponte para outro agente.** Crie um novo webhook. Uma edição não pode trocar de plataforma nem alterar configurações como o ID do agente ou a URL de webhook.
- **Pause ou remova.** Pausar um webhook interrompe suas entregas. Excluí-lo apaga suas credenciais.
- **Leia as falhas.** A lista de tentativas de um webhook mostra cada entrega com o status e o corpo da resposta da plataforma, ou nenhum quando não foi possível alcançar a plataforma. Uma tentativa que falhou antes de Bird enviar qualquer coisa, como uma conexão alterada após o evento, traz um `failure_reason` no lugar.

## Próximos passos

- [Webhooks e eventos](/docs/guides/webhooks)
- [Servidor MCP](/docs/ai/mcp-server)
- [Configure seu agente de código](/docs/ai/set-up-your-agent)

## 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)