Envie seu primeiro e-mail com a Inbixio em 5 minutos

A Inbixio transforma a conta de e-mail que você já tem em uma API HTTPS limpa e protegida por chave. Em vez de abrir conexões SMTP a partir de cada serviço que você roda, seu código faz uma única requisição POST e a Inbixio cuida da conversa com o seu servidor de e-mail.

Este guia leva você de uma conta nova a um e-mail entregue. Você precisa de cerca de cinco minutos, uma conta de e-mail com suporte a SMTP (uma caixa do Google Workspace, do Microsoft 365, do Zoho ou do seu provedor de hospedagem funciona) e um terminal.

Como a Inbixio se encaixa na sua stack

Antes dos passos, ajuda entender as peças envolvidas:

1. Seu app envia uma requisição JSON para a API da Inbixio com uma chave de API.
2. A Inbixio verifica a chave, as permissões dela e o limite mensal do seu plano, e então coloca a mensagem na fila.
3. Seu servidor SMTP (o que você conecta no passo 2) faz a entrega. A Inbixio faz login, atualiza a conexão para TLS e entrega a mensagem.
4. Seu painel mostra quantos e-mails saíram, que parcela falhou e quanto tempo o seu servidor levou para aceitá-los.

Como a mensagem sai pelo seu próprio servidor de e-mail, ela é enviada do seu próprio endereço e domínio, e a reputação que você construiu com os provedores de caixa de entrada continua sendo sua.

Passo 1: crie sua conta e escolha um plano

Acesse app.inbixio.com/create-account e preencha seu nome, endereço de e-mail, nome da empresa, telefone e endereço comercial; depois, escolha uma senha.

A Inbixio envia um link de verificação para o endereço que você usou. Abra o link e faça login. No primeiro login, você vai escolher um plano; o checkout é processado com segurança pela Stripe. Os planos se diferenciam principalmente pelo volume mensal. Se você não tem certeza de qual precisa, leia como estimar seu volume de e-mails.

Passo 2: conecte seu servidor SMTP

No painel, abra Email Servers (servidores de e-mail) e escolha Add Server (adicionar servidor). Você vai ver quatro campos e duas chaves:

Dois detalhes poupam muita depuração depois:

• O nome de usuário também é o seu remetente. A Inbixio envia do endereço com o qual você faz login, então use uma caixa de e-mail real no seu próprio domínio, como hello@ ou notifications@, em vez de uma caixa pessoal.
• Muitos provedores exigem uma senha de app. O Google, por exemplo, exige a verificação em duas etapas e uma senha de app de 16 caracteres para SMTP. Sua senha normal será recusada.

Não sabe o que preencher? O artigo configurações SMTP explicadas mostra hosts, portas e TLS dos provedores mais comuns.

Passo 3: gere uma chave de API

Abra API Keys (chaves de API) e escolha Create Api Key (criar chave de API). Dê a ela um nome que diga onde ela vai ficar, por exemplo production-backend ou staging-signup-service, e então defina:

• Server Access (acesso ao servidor): All Server (todos os servidores) envia pelo primeiro servidor de e-mail que você conectou. Selected Server (servidor selecionado) vincula a chave a um servidor. Se você tem mais de um endereço de envio, dê a cada serviço uma chave vinculada ao servidor dele; é assim que você controla de qual endereço ele envia.
• Permissions (permissões): marque Send (enviar) para que a chave possa enviar e-mails. Dê a cada chave apenas as permissões de que ela precisa.

Escolha Generate API Key (gerar chave de API) e copie a chave. As chaves da Inbixio começam com ibx_. Guarde-a como uma senha: no seu gerenciador de segredos ou em uma variável de ambiente, nunca em código de frontend ou em um repositório público. O artigo segurança de chaves de API detalha rotação e restrição de permissões.

Passo 4: envie seu primeiro e-mail

Exporte a chave e envie uma requisição com curl:

export INBIXIO_API_KEY="ibx_your_key_here"

curl -X POST https://backend.inbixio.com/api/send-email/ \
  -H "X-API-Key: $INBIXIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "you@example.com",
    "subject": "Hello from Inbixio",
    "message": "<h1>It works!</h1><p>My first email sent through the Inbixio API.</p>"
  }'

Uma requisição bem-sucedida retorna HTTP 200:

{ "message": "Email queued successfully." }

Confira sua caixa de entrada. O e-mail chega do endereço que você usou como nome de usuário SMTP.

Mantenha a barra final. O endpoint é /api/send-email/. Sem a / no final, o servidor responde com um redirecionamento, e muitos clientes HTTP não reenviam o corpo da requisição depois de um redirecionamento.

O corpo da requisição tem três campos obrigatórios:

Passo 5: confirme a entrega no painel

“Na fila” significa que a Inbixio aceitou a requisição e iniciou a entrega em segundo plano. A entrega por SMTP acontece um instante depois, e os resultados se acumulam no seu Dashboard (painel):

• Email Sent (e-mails enviados) conta os envios bem-sucedidos dos últimos 7 dias.
• Failed Deliveries (entregas com falha) mostra a parcela de e-mails que o seu servidor SMTP recusou nos mesmos 7 dias.
• Avg Latency (latência média) mostra quanto tempo o seu servidor SMTP leva para aceitar as mensagens.
• A tabela de logs (registros) lista cada chamada à API com ID do evento, endpoint, código de status e tempo de resposta.

Se o seu e-mail de teste não chegar e a taxa de falhas subir, a causa quase sempre está nas configurações do servidor: uma senha errada, um provedor que exige senha de app, ou o host ou a porta errados. Confira tudo em Email Servers e envie outro teste.

Erros comuns na primeira requisição

Para retentativas, limites mensais e tratamento de erros pronto para produção, veja como lidar com erros e limites da API de e-mail.

Próximos passos

Agora você tem um fluxo funcionando do seu código até a caixa de entrada dos seus usuários. A partir daqui:

• Envie a partir da sua stack real com os exemplos em Node.js, Python e cURL.
• Garanta que suas mensagens cheguem à caixa de entrada com o checklist de SPF, DKIM e DMARC.
• Crie os e-mails que os usuários ficam esperando: OTP e códigos de verificação e redefinições de senha.