Módulo Chat

API de Chat

Gestiona conversaciones y mensajes a través de todos los canales digitales unificados de CIFRA 360: WhatsApp, Web Chat, Instagram, Telegram y más.

Actualizado: Marzo 2026 Endpoint base: /v1/chat

Conversaciones

Una conversation es el hilo de mensajes entre un contacto y tu equipo a través de un canal específico. Cada conversación tiene un estado (open, resolved, pending) y puede estar asignada a un agente.

Listar conversaciones

GET /v1/chat/conversations

Parámetro	Tipo	Descripción
`status`	string	Filtrar por: open, resolved, pending
`channel`	string	Filtrar por canal: whatsapp, web, instagram
`assigned_to`	string	ID del agente asignado

Crear conversación

POST /v1/chat/conversations

JSON · Body

{
  "contact_id": "cnt_01HX2K9ABCDE",
  "channel": "whatsapp",
  "channel_id": "wa_channel_abc",
  "initial_message": "Hola, ¿en qué le podemos ayudar?"
}

Mensajes

Los mensajes son los elementos individuales dentro de una conversación. Pueden ser de texto, imagen, documento, audio, video o plantillas estructuradas (templates).

Enviar un mensaje

POST /v1/chat/conversations/{id}/messages

cURL · Mensaje de texto

curl -X POST https://api.cifra360.co/v1/chat/conversations/conv_01/messages \
  -H "Authorization: Bearer TU_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "text",
    "content": "Gracias por contactarnos. Le responderemos en breve.",
    "sender": "agent"
  }'

Para enviar mensajes de plantilla por WhatsApp fuera de la ventana de 24h, usa type: "template" con un template_id aprobado por Meta.

Canales soportados

CIFRA 360 unifica múltiples canales de mensajería en una sola API. Cada canal tiene sus propias capacidades de tipo de mensaje.

whatsapp WhatsApp Business

Texto, imagen, audio, video, doc, template, botones, listas

web Web Chat

Texto, imagen, archivo, botones rápidos

instagram Instagram DM

Texto, imagen, sticker, stories

telegram Telegram

Texto, imagen, audio, video, doc, botones inline

API de Voz API de Tickets