# Design it in Rocket. Wire it to Bird.

Import the Bird API into Rocket as a Postman collection. Attach a request to a screen, and Rocket writes the call for email, SMS, WhatsApp, voice, or verification.

[Get Started](/dashboard/signup)

[Contact Sales](/demo)

## Do prompt ao entregue.

Seu agente pode configurar canais, gerenciar clientes e confirmar a entrega. Acesso completo de leitura e escrita via MCP e CLI.

**MCP**: `https://mcp.bird.com`

```json
{
  "name": "voice_legs_list"
}
```

Examples: [MCP](/pt-br/ai/rocket.mcp.md) · [CLI](/pt-br/ai/rocket.cli.md) · [TypeScript](/pt-br/ai/rocket.ts.md) · [Python](/pt-br/ai/rocket.py.md) · [Go](/pt-br/ai/rocket.go.md) · [PHP](/pt-br/ai/rocket.php.md) · [HTTP](/pt-br/ai/rocket.http.md)

## Importe Bird no Rocket. Depois conecte uma tela.

O Rocket lê as solicitações de uma coleção. Sua chave de API fica no ambiente da tarefa.

Coleção Bird para o Rocket [Baixar coleção](/postman/bird-api-rocket.postman_collection.json)

```
bird-api-rocket.postman_collection.json
```

Ambiente

```
BIRD_API_KEY=bk_us1_…
BIRD_API_URL=https://us1.platform.bird.com
```

-

### Faça upload da coleção

Na sua tarefa do Rocket, clique em … na barra de ferramentas de pré-visualização e escolha APIs. Abra Select an API, clique em Add APIs, escolha Upload JSON, arraste a coleção e clique em Submit.

-

### Conecte uma solicitação a uma tela

Escolha uma rota e uma solicitação como Create an email message, clique em Integrate API e depois clique no elemento para disparar o envio. O Rocket pergunta quando chamar a API e escreve o código.

-

### Defina sua chave de API

Crie uma chave de API em Bird em Developers e depois em API keys. No Rocket, clique no nome da tarefa, abra Settings, depois Environment, e defina BIRD_API_KEY e BIRD_API_URL nas abas Staging e Production. Uma chave que começa com bk_eu1_ chama https://eu1.platform.bird.com.

[Explore a API](/docs/api)

## Criado com um agente. Pronto para os seus usuários.

O app publicado precisa da sua própria conexão server-side com a Bird.

### Mantenha a chave no servidor

Rocket mantém BIRD_API_KEY no ambiente da tarefa. Não use o prefixo NEXT_PUBLIC_, assim a chave fica no código do servidor e fora do navegador.

[Explore a API](/docs/api)

### Use um remetente que você controla

Verifique o domínio do seu e-mail ou configure um remetente elegível para o canal escolhido.

[Prepare seu primeiro envio](/docs)

### Mostre o resultado real

Salve o ID da mensagem. Atualize seu app a partir do status da mensagem ou dos eventos de entrega.

[Acompanhe o resultado](/docs/guides/webhooks)

## Alguns bons lugares para começar.

Diga ao Rocket o que deve acontecer e nomeie a solicitação da Bird a ser chamada.

Enviar um e-mail de boas-vindas

```
When a user signs up, call Create an email message to send a welcome email. Save the returned message ID on the user.
```

Enviar uma atualização de pedido por SMS

```
When an order ships, call Create an SMS message with the customer’s phone number and the tracking link. Show an error on the order page if the call fails.
```

Verificar um número de telefone

```
On the sign-up screen, call Create a verification for the phone number the user enters. On the next screen, call Create a verification passcode check with the code they type.
```

## Antes da sua primeira tarefa.

Os detalhes por trás de uma conexão funcionando.

Por que uma coleção do Postman?

O painel de APIs do Rocket importa coleções do Postman, comandos cURL e arquivos OpenAPI. A coleção do Bird fornece a cada solicitação um exemplo funcional e nomeia suas variáveis para o ambiente do Rocket.

Qual host meu app chama?

O host que a sua chave de API indica. Uma chave que começa com bk_us1_ chama https://us1.platform.bird.com, e uma que começa com bk_eu1_ chama https://eu1.platform.bird.com. Defina BIRD_API_URL de acordo.

Como obtenho novas solicitações do Bird?

Baixe a coleção novamente e faça upload do arquivo na sua tarefa. O Bird reconstrói a coleção a partir da sua especificação de API a cada lançamento.

## Continue construindo. Tudo se conecta.

Dê o próximo passo com as ferramentas e guias para o seu projeto.

- [Referência da API](/docs/api) — Consulte os campos e respostas de cada solicitação.

- [Webhooks](/docs/guides/webhooks) — Envie eventos de entrega de volta para o seu app.

- [Outras ferramentas de IA](/ai) — Use o mesmo espaço de trabalho a partir de outra ferramenta.



## Related resources

- [Setting up your coding agent](/learn/basics/setting-up-your-coding-agent) (video)
- [Set up your coding agent](/docs/ai/set-up-your-agent) (docs)
- [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)
- [Build with AI agents](/learn/paths/agents) (course)

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