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.

Este guia te leva do zero à sua primeira mensagem de WhatsApp enviada pela API.
1

Obtenha sua API key

A API key é emitida pelo dashboard, em Configurações → API. Ela tem o prefixo sk_1to1_.
A API key dá acesso completo às conversas do seu negócio. Trate-a como um segredo — nunca a coloque em código cliente nem a suba a um repositório.
2

Identifique seu negócio

Todos os endpoints partem de uma base URL que inclui o {slug} do seu negócio:
https://app.1to1.ai/api/v1/public/{slug}
O {slug} também está nas configurações da API. A key e o slug devem corresponder ao mesmo negócio.
3

Envie sua primeira mensagem

Um POST ao endpoint de texto, com a conversa identificada por telefone:
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text" \
  -H "Authorization: Bearer sk_1to1_sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "body": "Olá 👋, como posso ajudar?"
  }'
4

Trate a resposta

Uma resposta 201 confirma o envio:
{ "message_uuid": "...", "wamid": "..." }
Os erros retornam { code, message? } com um status 4xx ou 5xx. Faça switch sobre code (estável), nunca sobre message (que pode mudar):
{ "code": "WINDOW_CLOSED", "message": "..." }
Rate limit: 60 requisições por minuto por API key. Ao exceder você recebe um 429 com o header Retry-After. Ver Rate limits.

​
Próximos passos

Conversas

Como identificar uma conversa e a janela de 24h.

Mensagens

As quatro formas de enviar uma mensagem.