Marcio Cunha
Voltar ao Blog
BackendAutomação

Como Criar Templates Visuais na Brevo e Disparar via Chamada de API

Descubra o passo a passo para desenhar layouts de e-mail no construtor visual da Brevo e automatizar o envio em massa ou transacional utilizando chamadas de API com payloads JSON.

Marcio Cunha•2 min
Também disponível em:EspañolEnglish
Resumo
  • O layout fica no construtor da Brevo. A API só envia o número do template e os dados.
  • Variáveis do disparo usam a forma params no corpo e no template.
  • O template precisa estar ativo. Rascunho não dispara.
  • A chamada é POST em /v3/smtp/email com o cabeçalho api-key.
  • 401 é chave. 400 costuma ser templateId ou parâmetro que o layout espera e não veio.

O que fica no painel e o que fica no código

A Brevo separa o desenho do e-mail do disparo. Marketing monta o HTML no construtor visual, com colunas, botão e logo. O backend não reenvia esse HTML. Ele manda o identificador numérico do template e um objeto com os textos que mudam a cada destinatário.

Esse número, o templateId, aparece nos detalhes do template transacional. Enquanto o template estiver em rascunho, a API recusa o envio. Ative-o no painel antes de testar a chamada.

Passo a passo

Crie o template, marque os espaços dinâmicos e só então chame a API. A chave fica no servidor, nunca no navegador.

  1. No painel da Brevo, crie um template transacional e termine o layout no construtor.
  2. Onde o texto muda, insira uma variável no formato params, por exemplo o nome do destinatário. Salve e ative o template.
  3. Copie o ID numérico. Crie uma chave de API com permissão de envio e guarde-a só no ambiente do servidor.
  4. Envie POST para https://api.brevo.com/v3/smtp/email com o cabeçalho api-key e o corpo JSON.
  5. No corpo, informe sender, to com o e-mail do destinatário, templateId e params com as mesmas chaves desenhadas no layout.
  6. Leia a resposta. 201 significa que a Brevo aceitou o disparo. Abra o e-mail e confira se o nome substituiu o espaço do template.
curl -X POST https://api.brevo.com/v3/smtp/email \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'api-key: SUA_CHAVE' \
  -d '{"sender":{"email":"[email protected]","name":"Avisos"},"to":[{"email":"[email protected]"}],"templateId":12,"params":{"nome":"Ana"}}'

No layout, o espaço correspondente usa a chave nome dentro de params. Se o construtor mostrar outro prefixo, use o que a pré-visualização da própria Brevo substitui, e mande essa mesma chave em params.

Erros comuns

A maior parte das falhas é de cadastro, não de HTTP. O JSON pode estar certo e o template ainda não estar ativo.

  • 401: a chave está ausente, revogada ou sem permissão de SMTP.
  • 400 com templateId: o número não existe nesta conta ou o template segue como rascunho.
  • O e-mail sai com o espaço em branco: a chave em params não é a mesma desenhada no layout.
  • O remetente precisa ser um domínio autenticado na Brevo. E-mail solto costuma ser recusado.

Conclusão

O construtor guarda o visual. A chamada manda templateId, destinatário e params. Com o template ativo, essa é a ponte inteira.

Trocar um texto do layout não exige deploy. Trocar uma chave de params exige acertar os dois lados: o bloco no construtor e o objeto no JSON.