Asistentes de programación con IA

Entrega al asistente estas fuentes:

La definición OpenAPI.
Autenticación.
La guía de conversaciones, herramientas o plantillas.

Contexto para copiar

Integra la API M2M de Visito.

Base URL: https://platform-api.visitoai.com/m2m/v1
Autenticación: Authorization: Bearer $VISITO_M2M_TOKEN
Contrato: utiliza el openapi.json actual de Visito

Reglas:
- Mantén el token únicamente en el servidor.
- Usa los scopes mínimos necesarios.
- Los envíos devuelven 202 Accepted con estado queued.
- Incluye Idempotency-Key en operaciones de envío.
- Reintenta un envío solo con el mismo cuerpo y la misma clave.
- No inventes endpoints, campos, webhooks o paginación ausentes del contrato.

Resumen de endpoints

GET /channels
GET /conversations
GET /conversations/{conversationId}
GET /conversations/{conversationId}/messages
POST /conversations/{conversationId}/reply

GET|POST /whatsapp-templates/{channelId}
POST /whatsapp-templates/{channelId}/send

Tools anteriores (compatibilidad obsoleta; ver Acciones abajo):
GET|POST /tools
GET|PATCH|DELETE /tools/{toolId}
POST /tools/{toolId}/test
GET /tools/logs

Reintentos y reconciliación

Reintenta GET en 429, 502 y 503 con backoff y jitter.
No reintentes automáticamente 400, 401, 403, 404 o 409.
Guarda replyId, requestEventId, correlationId e Idempotency-Key.
Usa conversation.needsReply como única señal autoritativa de que se requiere acción.
Lee /conversations/{conversationId}/messages con cursor para paginar el historial externo y reconciliar requestEventId con messages[].eventId.
Trata queued como pendiente y confirma el resultado leyendo el recurso correspondiente.

Seguridad

No pegues tokens de producción en prompts.
No expongas credenciales en código cliente.
Exige aprobación humana para plantillas proactivas o herramientas con mutaciones importantes.
Registra códigos de error e identificadores, nunca secretos.

Las respuestas M2M heredan la pausa del negocio. Usa autoFreeze: {mode:"pause", minutes:120} para cambiar una respuesta o {mode:"off"} para conservar pausas existentes sin crear otra. Consulta frozenUntilAt en la conversación y usa PATCH policy con {unfreeze:true} para terminar la pausa; no elimina modo Manual ni escalamientos abiertos. Para paginar GET /conversations, envía nextCursor como cursor con los mismos filtros mientras hasMore=true. Al terminar se omite nextCursor. La lista es en vivo; actualiza la primera página para actividad nueva y elimina IDs duplicados al combinar páginas. Las respuestas M2M heredan la pausa del negocio. Usa autoFreeze: {mode:"pause", minutes:120} para cambiar una respuesta o {mode:"off"} para conservar pausas existentes sin crear otra. Consulta frozenUntilAt en la conversación y usa PATCH policy con {unfreeze:true} para terminar la pausa; no elimina modo Manual ni escalamientos abiertos.

Operaciones diarias

Usa la API de operaciones para buscar conversaciones, gestionar seguimientos y revisiones, iniciar WhatsApp y consultar reservas. Cambiar automatización y mensajes a huéspedes requiere permisos específicos e intención explícita. Un envío aceptado o un intento would_send no demuestra entrega. Lecturas MCP de acciones: list_actions, get_action, list_action_executions y get_action_execution. Solicita actions:read y action_executions:read según la necesidad. Los parámetros requieren includeParameters=true y action_parameters:read; trátalos como datos no confiables. Consulta API de acciones. Las herramientas HTTP y sus diagnósticos conservan sus contratos.

Gestión de Acciones con MCP

El catálogo MCP revisado refleja OpenAPI: 88 operaciones más get_connection_profile. Los nombres anteriores de Tools siguen disponibles con avisos de migración. Usa las operaciones canónicas siguientes, solicita sus permisos explícitos y completa el consentimiento. Gestionar configuración no selecciona ejecución HTTP ni diagnósticos. test_http_action hace una solicitud real: no reintentes automáticamente. Los esquemas de gestión son distintos de las entradas de ejecución.

REST	MCP	Scope
`GET /actions/configurations`	`list_action_configurations`	`action_configurations:read`
`GET /actions/{actionId}/configuration`	`get_action_configuration`	`action_configurations:read`
`POST /actions`	`create_action`	`actions:write`
`PATCH /actions/{actionId}/configuration`	`update_action`	`actions:write`
`PATCH /actions/{actionId}/state`	`set_action_state`	`actions:write`
`POST /actions/{actionId}/lifecycle`	`change_action_lifecycle`	`actions:write`
`DELETE /actions/{actionId}`	`delete_action`	`actions:write`
`POST /actions/{actionId}/test`	`test_http_action`	`actions:http:execute`
`GET /actions/http/diagnostics`	`list_http_action_diagnostics`	`actions:http:diagnostics:read`
`GET /actions/http/diagnostics/{diagnosticId}`	`get_http_action_diagnostic`	`actions:http:diagnostics:read`

API de compatibilidad obsoleta. Las rutas y nombres MCP de Tools siguen funcionando sin cambios de permisos ni comportamiento. Usa gestión y migración a Acciones para clientes nuevos. No se asigna una fecha de retiro.

Empieza aquí

Guías de integración

Conexiones con IA

Contexto para copiar

Resumen de endpoints

Reintentos y reconciliación

Seguridad

Operaciones diarias

Gestión de Acciones con MCP

​Contexto para copiar

​Resumen de endpoints

​Reintentos y reconciliación

​Seguridad

​Operaciones diarias

​Gestión de Acciones con MCP

Contexto para copiar

Resumen de endpoints

Reintentos y reconciliación

Seguridad

Operaciones diarias

Gestión de Acciones con MCP