Como funciona o envio

Entenda o pipeline do Publiq: da chamada de API à caixa de entrada, com fila, renderização, entrega e eventos de observabilidade.

Quando você chama emails.send, o Publiq aceita e enfileira o e-mail e devolve na hora um id com status queued. O envio real acontece de forma assíncrona — sua requisição não fica bloqueada esperando o provedor.

O pipeline

Aceite — a API valida o pedido (remetente, destinatário, template) e cria a mensagem com status queued.
Renderização — o corpo é montado: template + variáveis, tracking de abertura/clique e link de descadastro assinado.
Entrega — o provedor envia; o status vira sent e depois delivered (ou bounced).
Engajamento — aberturas e cliques viram eventos opened / clicked.
Observabilidade — cada transição vira um evento disponível por Webhooks e no painel.

Por ser assíncrono, um 202 queued significa "aceito", não "entregue". Use Webhooks para saber o resultado final de cada e-mail.