Crear Agente
Crea un nuevo agente en tu workspace.
POST https://api.platica.mx/v1/agentsCuerpo de la solicitud
{
"name": "Mi Asistente",
"channel": "whatsapp",
"systemPrompt": "Eres un asistente especializado en atención al cliente...",
"channelId": ["channel-123"],
"phoneNumber": ["+1234567890"],
"imageUrl": "/images/mi-asistente.png",
"status": "active",
"supportInformation": {
"supportPhone": "+1234567890",
"supportEmail": "soporte@miempresa.com",
"supportAddress": "Calle Principal #123",
"outOfServiceBehavior": "limited",
"serviceHours": {
"monday": {
"availability": "Abierto",
"start": "9:00am",
"end": "5:00pm"
},
"tuesday": {
"availability": "Abierto",
"start": "9:00am",
"end": "5:00pm"
},
"saturday": {
"availability": "Cerrado",
"start": "Cerrado",
"end": "Cerrado"
},
"sunday": {
"availability": "Cerrado",
"start": "Cerrado",
"end": "Cerrado"
}
}
},
"assistanceTriggers": "",
"assistanceEnabled": true,
"recallLastConversation": false
}Parámetros del cuerpo
| Parámetro | Tipo | Descripción | Requerido | Valor por defecto |
|---|---|---|---|---|
name | string | Nombre del agente (1-100 caracteres) | ✓ | — |
channel | string | Plataforma del agente | — | "whatsapp" |
systemPrompt | string | Prompt del sistema para el agente | — | "" |
channelId | string | array | ID(s) del canal de comunicación. Puede ser un ID interno o array de IDs. | — | null |
phoneNumber | string | array | Número(s) de teléfono (formato internacional) o array de números. | — | null |
imageUrl | string | URL de la imagen del agente | — | "/images/campaignCreator.png" |
status | string | Estado del agente | — | "inactive" |
supportInformation | object | Información de soporte y horarios. Ver detalles abajo. | — | Configuración por defecto (ver abajo) |
assistanceTriggers | string | Disparadores de asistencia | — | "" |
waitMessage | string | Mensaje de espera | — | "" |
assistanceEnabled | boolean | Si la asistencia está habilitada | — | true |
recallLastConversation | boolean | Si debe recordar la última conversación | — | false |
{
"supportAddress": "",
"supportEmail": null,
"supportPhone": null,
"outOfServiceBehavior": "limited",
"serviceHours": {
"monday": { "availability": "Abierto", "start": "9:00am", "end": "5:00pm" },
"tuesday": { "availability": "Abierto", "start": "9:00am", "end": "5:00pm" },
"wednesday": { "availability": "Abierto", "start": "9:00am", "end": "5:00pm" },
"thursday": { "availability": "Abierto", "start": "9:00am", "end": "5:00pm" },
"friday": { "availability": "Abierto", "start": "9:00am", "end": "5:00pm" },
"saturday": { "availability": "Cerrado", "start": "Cerrado", "end": "Cerrado" },
"sunday": { "availability": "Cerrado", "start": "Cerrado", "end": "Cerrado" }
}
}| Valor | Descripción |
|---|---|
whatsapp | Canal de WhatsApp Business |
telegram | Canal de Telegram |
instagram | Canal de Instagram Direct |
facebook | Canal de Facebook Messenger |
sms | Canal de mensajes SMS |
Respuesta
{
"status": "success",
"message": "Agent created successfully",
"data": {
"id": "agent_abc123"
}
}