Asistentes, voz y conocimiento

Endpoints para tus asistentes de chat, agentes de voz y la base de conocimiento.

Asistentes de chat

Método	Ruta	Descripción
GET	/workspaces/:workspaceId/agents	Listar asistentes
POST	/workspaces/:workspaceId/agents	Crear asistente
GET	/workspaces/:workspaceId/agents/:id	Obtener asistente
PATCH	/workspaces/:workspaceId/agents/:id	Actualizar
DELETE	/workspaces/:workspaceId/agents/:id	Eliminar
POST	/workspaces/:workspaceId/agents/:id/duplicate	Duplicar
POST	/workspaces/:workspaceId/agents/:id/chat	Enviar mensaje al asistente (prueba)

Agentes de voz y llamadas

Método	Ruta	Descripción
GET	/workspaces/:workspaceId/voice-agents	Listar agentes de voz
POST	/workspaces/:workspaceId/voice-agents	Crear agente de voz
GET	/workspaces/:workspaceId/voice-agents/:id	Obtener
PATCH	/workspaces/:workspaceId/voice-agents/:id	Actualizar
GET	/workspaces/:workspaceId/voice-calls	Historial de llamadas
GET	/workspaces/:workspaceId/voice-calls/:id	Detalle de una llamada

Base de conocimiento

Método	Ruta	Descripción
GET	/workspaces/:workspaceId/knowledge	Listar documentos
POST	/workspaces/:workspaceId/knowledge/upload	Subir documento
DELETE	/workspaces/:workspaceId/knowledge/:id	Eliminar documento

Ejemplo — chatear con un asistente

POST /workspaces/:workspaceId/agents/:id/chat Copiar

Cuerpo de la petición

Campo	Tipo	Requerido	Descripción
message	string	Sí	Mensaje del usuario.
sessionId	string	No	Sesión para mantener contexto.

cURL

curl -X POST "https://api.waiify.com/workspaces/WORKSPACE_ID/agents/AGENT_ID/chat" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "message": "¿Cuál es el horario de atención?" }'

Node

const res = await fetch(
  'https://api.waiify.com/workspaces/WORKSPACE_ID/agents/AGENT_ID/chat',
  {
    method: 'POST',
    headers: {
      Authorization: 'Bearer TU_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ message: '¿Cuál es el horario de atención?' }),
  }
);
const reply = await res.json();

Python

import requests

res = requests.post(
    "https://api.waiify.com/workspaces/WORKSPACE_ID/agents/AGENT_ID/chat",
    headers={"Authorization": "Bearer TU_TOKEN"},
    json={"message": "¿Cuál es el horario de atención?"},
)
reply = res.json()

Respuesta 200

{
  "reply": "Atendemos de lunes a viernes de 9 a 18 h.",
  "sessionId": "s1a2b3-..."
}