Templates hospedados

Ciclo de vida

Um template tem um ID e uma chave estáveis, um rascunho editável, zero ou mais versões publicadas imutáveis e um ciclo de vida ativo ou arquivado. Arquivar impede novos envios por chave sem excluir as versões históricas nem o histórico de uso.

Variáveis

Declare as variáveis com chaves, tipos, obrigatoriedade e valores padrão opcionais. A renderização falha com 422 quando os dados fornecidos não atendem ao contrato publicado. Os valores inseridos são escapados de acordo com o contexto.

Salvamento automático otimista

Cada rascunho tem uma revisão. Envie a revisão atual para PUT /templates/:id/draft. Se outro editor tiver salvado antes, o SendHQ retorna 409; recarregue antes de sobrescrever.

Pré-visualizar, testar, publicar

1. Renderize com dados de exemplo representativos.
2. Resolva todos os erros encontrados.
3. Envie um snapshot de teste para um endereço que você controla.
4. Publique o rascunho exato como uma versão imutável.

Enviar por chave

{
  "from": "hello@example.com",
  "to": [
    "customer@example.net"
  ],
  "template": {
    "key": "account-welcome",
    "data": {
      "first_name": "Asha"
    }
  }
}

Um envio de template personalizado exige exatamente um destinatário To e nenhum Cc ou Bcc. Use o endpoint de lote para destinatários individualizados.

Procedência

Cada envio de template registra o template, a versão, a versão do compilador e o hash do conteúdo renderizado, para que uma mensagem histórica possa ser rastreada até o conteúdo que a gerou.