Python
Envie seu primeiro e-mail a partir de um script Python simples usando o cliente síncrono do Bird Python SDK. Três passos: instalar, enviar, executar.
1. Instale o SDK
Exemplo de código
python -m pip install messagebird-sdkRequer Python 3.10+. O pacote de importação é bird.
2. Envie um e-mail
Exporte sua chave API. O SDK lê BIRD_API_KEY do ambiente e infere a região (us1 ou eu1) a partir do prefixo bk_us1_ / bk_eu1_, então Bird() não precisa de argumentos:
Exemplo de código
export BIRD_API_KEY="bk_us1_..."Crie send.py:
Exemplo de código
from bird import APIError, Bird
with Bird() as client:
try:
message = client.email.send(
from_={"email": "onboarding@messagebird.dev", "name": "Bird"},
to=["delivered@messagebird.dev"],
subject="Hello from Bird",
html="<p>My first Bird email.</p>",
)
print(message.id, message.status)
except APIError as err:
print("send failed:", err)from_ é a forma Python do campo from (from é uma palavra reservada). onboarding@messagebird.dev é o remetente compartilhado de onboarding do Bird (sem necessidade de verificação de domínio) e delivered@messagebird.dev é um destinatário sandbox que sempre entrega.
O SDK tenta novamente automaticamente em caso de falhas transitórias e reutiliza a chave de idempotência da chamada em cada tentativa. Isso evita que uma nova tentativa envie a mensagem duas vezes.
3. Execute
Exemplo de código
python send.pyO script imprime o ID da mensagem e o status:
Exemplo de código
em_01ky7ma8y2es1s2akzk53tmjn0 acceptedaccepted é o 202 do API: Bird recebeu a mensagem e a entrega de forma assíncrona. Consulte-a pelo em_ ID com client.email.get(message.id) e acompanhe o status mudar de accepted para delivered.
Próximos passos
- Referência do SDK Python: todos os métodos e opções.
- Envie seu primeiro e-mail: o mesmo fluxo com curl e a lista completa de endereços do sandbox.
- Domínios de envio: verifique seu próprio domínio para envio em produção.
- Referência do API de e-mail: o esquema completo de requisição e resposta.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.
Assista ao guiaTesting email without spamming anyoneExplore a funcionalidadeTest email deliverySiga o percurso de aprendizagemOperate messaging reliably
Experimente na prática e obtenha um resumo de implementação