🧩 ¿Cómo utilizar la API de Plantillas en Atom?

🌐 API de Plantillas de Atom (Template Messages)

La API de Plantillas te permite conectar tus aplicaciones internas con Atom para automatizar el envío de mensajes preaprobados por WhatsApp.
Ambientes disponibles:

Producción: Para clientes finales y operaciones reales.
• https://us-central1-atomchat-io.cloudfunctions.net/templates
AI: Ambiente alternativo para integraciones específicas.
• https://us-central1-atom-ai.cloudfunctions.net/templates

1️⃣ Enviar una Plantilla (Template Message)

Este servicio envía un mensaje usando tu número oficial y el ID de la plantilla. Si el cliente ya tiene un chat activo, el envío se confirma al instante; si es un contacto nuevo, el mensaje queda "pendiente" hasta que Meta lo confirme.

Método: POST
Encabezados (Headers):
• Content-type: application/json
• Charset: utf-8
• Authorization: Bearer (tu_token_público)

Parámetros del Body (JSON):

Parámetro	Descripción	Tipo	Requerido
templateId	ID del Template Message de AtomChat.	string	Sí
phoneNumber	Teléfono destino con código de país, sin el signo + ni espacios (Ej: 50755667788).	string	Sí
clientName	Nombre del cliente (por defecto toma el teléfono).	string	Opcional
groupName	Grupo al que se asignará el chat.	string	Opcional
assign	true para asignar a un agente, false para el bot.	boolean	Opcional
params	Objeto con las variables de la plantilla (Ej: {"param1": "valor"}).	object	Opcional

Respuestas comunes (Códigos HTTP):

200: Enviado exitosamente.
202: Pendiente de envío (contacto nuevo).
400: Faltan parámetros o datos incorrectos en la petición.
401: Canal no conectado, token inválido o límite de conversaciones alcanzado.
500: Error interno del servidor.

2️⃣ Listar Plantillas

Permite recuperar un listado de todas las plantillas activas disponibles en el canal asociado a tu token.

Método: GET
Endpoint (Ejemplo Producción): https://us-central1-atomchat-io.cloudfunctions.net/templates?page=1&size=1000&sort=asc
Parámetros de URL (Opcionales): page (página actual), size (cantidad de resultados) y sort (orden asc o desc).
Encabezados: Mismos que el método POST.

3️⃣ Obtener Plantilla por ID

Recupera los detalles completos de una plantilla específica.

Método: GET
Endpoint (Ejemplo Producción): https://us-central1-atomchat-io.cloudfunctions.net/templates/{templateId} (Reemplaza {templateId} por el ID real).
Encabezados: Mismos que el método POST.

⚠️ Consideraciones Finales

Valida el ambiente: Asegúrate de estar usando el endpoint correcto (Producción vs. AI) según la etapa de tu desarrollo.
Formato del teléfono: El error más común ocurre al enviar el phoneNumber. Recuerda: sin el signo + y sin espacios.
Lectura de errores: Si recibes un error 400 o 401, revisa el cuerpo de la respuesta, ya que el sistema te indicará exactamente qué parámetro falta o si hay problemas con tu token de autorización.

¡Lleva tu comunicación al siguiente nivel! 🚀

Al utilizar la API de Plantillas, puedes integrar Atom directamente con tu CRM, ERP o sistema interno para disparar alertas, confirmaciones y recordatorios masivos sin intervención manual. Asegúrate de estructurar bien tus JSON y valida siempre tus tokens de conexión. ✅