Saltar al contenido 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.

Esta guía te lleva del cero a tu primer mensaje de WhatsApp enviado por la API.
1

Obtén tu API key

La API key se emite desde el dashboard, en Configuración → API. Tiene el prefijo sk_1to1_.
La API key da acceso completo a las conversaciones de tu negocio. Trátala como un secreto — nunca la pongas en código cliente ni la subas a un repositorio.
2

Identifica tu negocio

Todos los endpoints cuelgan de una base URL que incluye el {slug} de tu negocio:
https://app.1to1.ai/api/v1/public/{slug}
El {slug} también está en la configuración de la API. La key y el slug deben corresponder al mismo negocio.
3

Envía tu primer mensaje

Un POST al endpoint de texto, con la conversación identificada por teléfono:
curl -X POST "https://app.1to1.ai/api/v1/public/{slug}/conversation/messages/text" \
  -H "Authorization: Bearer sk_1to1_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "conversation": { "phone": "+5215512345678" },
    "body": "Hola 👋, ¿en qué te puedo ayudar?"
  }'
4

Maneja la respuesta

Una respuesta 201 confirma el envío:
{ "message_uuid": "...", "wamid": "..." }
Los errores devuelven { code, message? } con un status 4xx o 5xx. Haz switch sobre code (estable), nunca sobre message (puede cambiar):
{ "code": "WINDOW_CLOSED", "message": "..." }
Rate limit: 60 requests por minuto por API key. Al excederlo recibes un 429 con el header Retry-After. Ver Rate limits.

​
Próximos pasos

Conversaciones

Cómo identificar una conversación y la ventana de 24h.

Mensajes

Las cuatro formas de enviar un mensaje.