Enviar

Envio de e-mails

Envie com segurança mensagens transacionais, lotes, respostas, anexos e templates hospedados.

Conteúdo da mensagem

Informe uma identidade from em um domínio verificado do workspace, pelo menos um destinatário to e o conteúdo em HTML, texto ou um template hospedado publicado. Um envio com conteúdo bruto pode omitir subject, o que gera um assunto vazio. O SendHQ gera uma alternativa em texto a partir do HTML quando necessário, mas uma alternativa escrita por você é mais confiável.

Destinatários e créditos

Uma mensagem pode ter no máximo 100 destinos somando To, Cc e Bcc. Cada destino consome um crédito de entrega por destinatário. Endereços de destinatário duplicados após a normalização são verificados uma única vez nas supressões, mas cada destino continua contando para os limites da mensagem.

Novas tentativas seguras

Envie uma Idempotency-Key estável de no máximo 200 caracteres em envios individuais e em lote. Reutilizar uma chave com o payload JSON idêntico reproduz a resposta armazenada e adiciona Idempotent-Replayed: true. Alterar qualquer destinatário, conteúdo, cabeçalho ou dado de template com a mesma chave retorna 409; uma requisição simultânea com essa chave também retorna 409 enquanto a primeira estiver pendente.

Envio em lote

POST /emails/batch aceita até 100 objetos de mensagem e retorna um resultado para cada posição. Use objetos de mensagem separados para dados de template personalizados, em vez de enviar um template personalizado para vários destinatários.

Respostas e threads

Defina reply_to_email_id ao responder. O SendHQ deriva Message-ID, In-Reply-To, References e o ID da thread existente. Obtenha a conversa completa com GET /threads/:id.

Modelo de status

queuedArmazenado antes do envio ao provedorsentAceito pelo provedordeliveredO servidor do destinatário aceitou a entregabouncedFalha permanente de entregacomplainedO destinatário marcou como spamfailedFalha no envio ao provedor