Conversaciones y mensajes

Gestiona el inbox: lista conversaciones, cambia su estado, toma el control y envía mensajes.

Conversaciones

Método	Ruta	Descripción
GET	/workspaces/:workspaceId/conversations	Listar conversaciones
POST	/workspaces/:workspaceId/conversations	Crear conversación
GET	/workspaces/:workspaceId/conversations/:id	Obtener conversación
PATCH	/workspaces/:workspaceId/conversations/:id	Actualizar (estado, asignación)
POST	/workspaces/:workspaceId/conversations/:id/take-control	Pausar la IA
POST	/workspaces/:workspaceId/conversations/:id/release-control	Devolver el control a la IA

Mensajes

Método	Ruta	Descripción
GET	/workspaces/:workspaceId/conversations/:id/messages	Listar mensajes
POST	/workspaces/:workspaceId/conversations/:id/messages	Enviar mensaje
DELETE	/workspaces/:workspaceId/conversations/:id/messages/:messageId	Eliminar mensaje

Ejemplo — enviar un mensaje

POST /workspaces/:workspaceId/conversations/:id/messages Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
text	string	Sí	Contenido del mensaje.
type	string	No	TEXT, IMAGE, DOCUMENT… (por defecto TEXT).

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/conversations/CONV_ID/messages" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "text": "¡Hola! Ya revisamos tu caso." }'

Node

await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/conversations/CONV_ID/messages',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ text: '¡Hola! Ya revisamos tu caso.' }),
  }
);

Python

import requests

requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/conversations/CONV_ID/messages",
    headers={"Authorization": "Bearer TU_TOKEN"},
    json={"text": "¡Hola! Ya revisamos tu caso."},
)

Respuesta 201

{
  "id": "m1a2b3-...",
  "role": "ASSISTANT",
  "type": "TEXT",
  "text": "¡Hola! Ya revisamos tu caso.",
  "createdAt": "2026-06-18T09:00:00.000Z"
}

Consejo

Para responder como humano, primero llama a take-control para pausar la IA en esa conversación.