ForHosting KIT · Avisos e automações

E-mail com template

O notify.email_template separa o modelo da mensagem dos dados de cada envio: você manda o template com a marca e o texto da empresa mais as variáveis — nome, valor, data — e a API monta e entrega o e-mail final. Para quem envia a mesma mensagem mil vezes com dados diferentes, pago por uso.

● Estávelpor e-mailUS$ 0,002

Ver a API — US$ 0,002 + US$ 0,0035/e-mail Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

Modelo e dados, cada um no seu lugar

Quando o texto do e-mail vive dentro do código, qualquer vírgula exige um deploy. Com template, o modelo carrega o layout, a saudação e a assinatura, e marca os pontos variáveis com campos como {{nome}} ou {{valor}}. Na hora de enviar, a chamada leva apenas os dados daquele destinatário. O texto pode evoluir sem tocar no sistema, e o sistema pode disparar mil mensagens sem conhecer o texto. Cada parte muda no seu próprio ritmo.

Um exemplo que todo negócio reconhece

Imagine o modelo de confirmação de encomenda: "Olá, {{nome}}! Recebemos seu pedido de {{item}} para retirar em {{data}}." A chamada envia um JSON com nome, item e data, e o destinatário recebe a mensagem completa, com a identidade visual da empresa. Amanhã, se o time quiser trocar a saudação ou acrescentar uma linha sobre horário de funcionamento, edita o template — e nenhum programador precisa entrar na história.

Menos risco de erro em produção

Texto montado por concatenação de strings é fábrica de acidente: acento perdido, espaço faltando, variável trocada — e o cliente recebe "Olá, undefined". O template reduz esse risco porque a estrutura é fixa e revisada uma vez só; o que varia são os dados, validados na chamada. Também garante consistência: toda mensagem da empresa sai com o mesmo tom, o mesmo rodapé e os mesmos dados de contato, seja quem for que dispare o envio.

Preço: o mesmo do e-mail comum

Usar template não custa nada a mais: são os mesmos US$ 0,002 por chamada e US$ 0,0035 por e-mail enviado de qualquer envio pelo KIT. Quinhentas mensagens de boas-vindas no mês somam US$ 2,75, com a conta publicada e sem surpresa no fim. Não há assinatura nem limite de templates diferentes que você pode usar: cada chamada leva o modelo e os dados que quiser.

Casos de uso

Boas-vindas de cliente novo

A TecnoSul Soluções Digitais recebe cada cliente com um e-mail que traz {{nome}} e {{plano}} contratado. O texto foi escrito uma vez pelo time comercial; o sistema só preenche os campos e dispara.

Encomenda pronta para retirar

A Padaria Pão Dourado avisa quando o bolo fica pronto: {{sabor}}, {{data_retirada}} e o endereço da loja entram no modelo. Juliana Nascimento recebe a mensagem certinha, e o balcão não digita mais aviso nenhum.

Convocação de entrevista

Márcia Regina Oliveira, do RH, agenda entrevistas com um template de convocação: {{vaga}}, {{horario}} e o link da chamada. Cada candidato recebe a mesma mensagem profissional, sem copiar e colar do bloco de notas.

Status de entrega

A Distribuidora Horizonte Verde envia a cada despacho um e-mail com {{pedido}} e {{previsao}} de chegada. O modelo é um só; os dados vêm do sistema de logística a cada disparo.

Perguntas frequentes

O template aceita HTML com a identidade visual da empresa?

Sim. O modelo pode ser HTML completo — logotipo, cores, tabela de dados — ou texto simples, se o assunto pede sobriedade. As variáveis funcionam nos dois formatos.

Acentos e caracteres do português funcionam nas variáveis?

Funcionam: ç, ã, é e companhia passam sem problema, tanto no modelo quanto nos dados. Se algum "João" virar "Jo?o", o problema está na codificação do seu lado — envie tudo em UTF-8.

Usar template encarece o envio?

Não. O preço é o mesmo do e-mail simples: US$ 0,002 por chamada mais US$ 0,0035 por mensagem enviada, pago por uso e em dólar.

Os dados que preenchem as variáveis ficam guardados?

São usados para montar e entregar a mensagem — essa é a finalidade. Boa prática de LGPD do seu lado: só mande nas variáveis o que a mensagem realmente precisa mostrar.

Preciso criar conta para usar?

Não tem cadastro nem conta: a compra é direta, via PayPal, em dólar. Você paga o uso e pronto.

Dá para testar o modelo antes de mandar para clientes?

Dá, e vale a pena: dispare primeiro para o seu próprio endereço e confira layout, variáveis e acentuação. O teste custa menos de um centavo de dólar.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/notify/email-template

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/notify/email-template \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/notify/email-template", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/notify/email-template",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/email-template", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/email-template", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "notify.email_template",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

por e-mailUS$ 0,0035

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →