Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt

Use this file to discover all available pages before exploring further.

Um template é uma mensagem pré-aprovada pela Meta. É o único tipo de mensagem que você pode enviar quando a janela de 24 horas está fechada — ou seja, quando o contato não escreveu para você nas últimas 24 horas. Enquanto a janela está aberta você pode enviar texto livre; uma vez fechada, apenas um template chega ao cliente.
Os templates são criados e aprovados no dashboard. A API pública apenas os consome para enviar — não os cria nem os edita.

​
Como um template é resolvido

1

Identifique o template pelo nome

Um template é identificado pelo seu template_name — o mesmo nome que você vê no dashboard e que reporta à Meta.
2

Especifique o idioma se for necessário

Se o mesmo nome estiver aprovado em vários idiomas, adicione language (formato Meta lower_UPPER, ex. pt_BR) para escolher qual enviar. Se só existir em um idioma, é opcional.
3

Verifique que esteja aprovado

Só é possível enviar templates com status APPROVED. Um em PENDING ou REJECTED não é enviável.

​
Componentes de um template

Ao enviar um template você preenche suas partes dinâmicas:

body_variables

Os placeholders do corpo ({{1}}, {{2}}, …). Array de objetos { index, value }.

header

O cabeçalho: texto, ou mídia via file_uuid.

button_parameters

Parâmetros de botões dinâmicos (ex. o sufixo de um botão URL).

​
Enviar um template

Um envio típico, com duas variáveis no corpo: 
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/template" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "template_name": "confirmacao_consulta",
    "language": "pt_BR",
    "body_variables": [
      { "index": 1, "value": "Ana" },
      { "index": 2, "value": "10:00 AM" }
    ]
  }'
Para descobrir quais templates você tem disponíveis e quais variáveis cada um espera, consulte os endpoints de catálogo de templates na Referência da API.

​
Próximos passos

Enviar mensagens

O envio de templates, texto, mídia e quick replies.

Conversas

A janela de 24 horas e o estado de uma conversa.