API de e-mail de entrada

Transforme e-mails recebidos em trabalho que seu app pode executar.

Receba e-mails por um endereço de encaminhamento ou um subdomínio que você controla. Bird analisa as mensagens recebidas para que sua aplicação possa ler o conteúdo e os anexos, e então reagir por meio de webhooks email.received. Crie fluxos de suporte, tratamento de respostas e processamento de documentos com a API de Email.

Crie sua conta, adicione um endereço de recebimento e conecte sua aplicação.

Parte da Bird de Email API

Do e-mail a um evento

Fluxo de recebimento

AL
Alex Lee

Para: support@inbound.example.com

Aqui está o documento assinado.

Obrigado pela ajuda. Anexei a cópia preenchida.

PDF signed-document.pdf
email.received

Webhook

Remetente

Corpo da mensagem

Anexos

Mensagem e evento ilustrativos. Seu handler de webhook recupera e processa o e-mail recebido.

Como funciona o recebimento de e-mail?

Escolha onde o e-mail deve chegar e decida como sua aplicação vai processá-lo. Um endereço de encaminhamento permite testar o recebimento sem alterações de DNS. Receber em seu próprio subdomínio permite que clientes enviem e-mails para um endereço que você controla. As mensagens analisadas ficam disponíveis no painel e pela API de mensagens de entrada.

Comece com a caixa de entrada que você já usa.

Crie um endereço de encaminhamento no Bird e adicione-o como destino de encaminhamento da sua caixa de entrada ou helpdesk existente. Bird recebe a mensagem encaminhada e armazena seu conteúdo analisado. Isso oferece uma primeira integração prática antes de alterar o roteamento do domínio.

Receba em um subdomínio que você controla.

Registre e verifique um subdomínio dedicado de recebimento, ative o recebimento e publique os registros MX fornecidos. Use um subdomínio como inbound.example.com para manter a configuração de recebimento separada do roteamento da sua caixa de e-mail corporativa. O guia de recebimento detalha as verificações de domínio.

Entregue à sua aplicação a mensagem que ela precisa.

Leia o remetente, destinatários, assunto, corpo e anexos, e use webhooks para acionar o fluxo da sua aplicação. Valide as assinaturas dos webhooks e trate novas tentativas conforme o contrato de eventos documentado. Se seu agente precisa de um endereço com conversas contínuas e respostas, explore Agent Mailboxes.

Perguntas antes de começar

Preciso alterar meu domínio para testar e-mail de entrada?
Não. Crie um endereço de encaminhamento Bird e encaminhe e-mails de uma caixa de entrada existente. Use recebimento por domínio quando quiser que e-mails sejam endereçados diretamente a um subdomínio que você controla.
Posso receber e-mail no meu próprio domínio?
Sim. Registre e verifique um subdomínio dedicado, habilite o recebimento e publique os registros MX fornecidos. Mantenha o roteamento de e-mail corporativo separado usando um subdomínio de recebimento.
Como minha aplicação fica sabendo de uma mensagem recebida?
Assine webhooks de email.received ou leia mensagens pela API de inbound-messages. Siga as orientações de verificação e retry de webhook ao processar eventos.
Qual a diferença entre e-mail de entrada e Agent Mailboxes?
O e-mail de entrada faz o parse de mensagens que chegam em endereços de encaminhamento ou domínios de recebimento para sua aplicação processar. O Agent Mailboxes oferece uma caixa de entrada própria do agente com threads de mensagens e um fluxo de resposta.

Transforme a próxima resposta em uma ação útil.

Configure um endereço de recebimento, inspecione uma mensagem recebida e conecte-a à sua aplicação.

Crie sua conta, adicione um endereço de recebimento e conecte sua aplicação.

Comece com um canal.
Adicione os outros quando estiver pronto.

Uma chave API de teste é sua imediatamente. A produção é desbloqueada quando você adiciona um método de pagamento e verifica um remetente.

Usa Claude Code, Cursor ou Codex? Copie um prompt de configuração e o seu agente instala o Bird CLI e as skills por si. Escolha o seu:

Cursor