Templates

Escreva uma vez, envie de qualquer número

Variáveis, cabeçalhos de mídia e botões em uma única definição. Números Linked Devices aprovam na hora; números Cloud API enviam para a Meta.

Começar a construir Ler o guia de modelos

Build

Uma definição para todas as rotas.

Escreva as variáveis pelo nome. A Polymorfa verifica a definição quando você salva e a converte para cada rota quando você envia.

Variáveis nomeadas. Variáveis de texto, número, moeda e data, cada uma com um exemplo. Números Cloud API recebem os marcadores numerados da Meta.

Cabeçalhos e botões. Um cabeçalho de texto, imagem, vídeo, documento ou localização. Respostas rápidas, links, telefone, copiar código e botões de fluxo.

Quatro tipos. Padrão, carrossel, autenticação e oferta por tempo limitado, nas categorias Marketing, Utility e Authentication.

Aprovação

Aprovação que acompanha o número.

Uma chamada de envio para aprovação funciona para todos os números. Veja o resultado de cada rota antes que algo chegue a um cliente.

Envio por número. Números Linked Devices retornam Approved sem revisão. Números Cloud API retornam Pending até a Meta decidir.

Status como eventos.Cloud API A decisão da Meta e mudanças de qualidade posteriores chegam nos seus webhooks como template.status.

Prévia de cada rota. Veja a mensagem como a Cloud API, o Linked Devices ou o Sandbox a exibem antes que algo chegue a um cliente.

No seu código

Modelos a partir do seu próprio código.

Crie, envie para aprovação e envie pelo SDK, pela CLI ou por HTTP puro. As campanhas usam os mesmos modelos aprovados.

Guia de modelos Documentação do SDK Documentação da CLI

templates.ts

import { MessagingClient } from "@polymorfa/sdk";

const messaging = new MessagingClient({
  credential: { type: "apiKey", value: apiKey },
});

const created = await messaging.templates.create("support", {
  name: "order_shipped",
  definition: {
    version: 1,
    kind: "standard",
    category: "UTILITY",
    language: "en_US",
    body: "Hi {{name}}, order {{order_id}} has shipped.",
    variables: [
      { name: "name", type: "text", example: "Marina" },
      { name: "order_id", type: "text", example: "#8412" },
    ],
  },
});

Superfície da API

A API de modelos.

Leituras exigem templates:read e alterações exigem templates:manage. O SDK de TypeScript cobre todas as rotas abaixo.

Documentação de modelos

Modelos do projeto

GET/messaging/projects/{projectSlug}/templatesListar os modelos do projeto
POST/messaging/projects/{projectSlug}/templatesCriar um modelo
PATCH/messaging/projects/{projectSlug}/templates/{id}Atualizar um rascunho
POST/messaging/projects/{projectSlug}/templates/{id}/previewGerar uma prévia
POST/messaging/projects/{projectSlug}/templates/{id}/submitEnviar para aprovação de um número

Rascunhos na Platform API

GET/platform/templatesListar rascunhos de toda a equipe
POST/platform/templatesCriar um rascunho
PATCH/platform/templates/{templateId}Atualizar um rascunho

Envio e eventos

POST/messaging/{session}/messages/sendEnviar com content.template
Eventotemplate.statusA Meta aprovou, rejeitou ou avaliou um modelo

Comece com um número grátis

Seu primeiro número real é grátis. Adicione mais números no Pay-As-You-Go.

Começar a construir Ver preços