Cambios

Esta página registra los cambios de la API. Un cambio incompatible solo llega en una versión nueva de la ruta y se anuncia aquí.

14 de octubre de 2026

Primera versión pública de la referencia de la API v1.

Contrato publicado. El documento OpenAPI 3.1 está en https://getricky.ai/openapi.json. Ricky lo genera desde el mismo contrato que valida cada solicitud. La referencia de esta documentación sale de ese documento.
Convenciones. Solicitudes y respuestas usan JSON con campos en snake_case. Un cuerpo con un campo desconocido recibe 400 invalid_input.
Listas. Toda lista responde { "data": [...], "next_cursor": ... }. Consulta Paginación.
Errores. Todo error responde { "error": { "code", "message", "param", "request_id" } }, con un catálogo de códigos estable. Consulta Errores.
Iniciar conversaciones. POST /conversations envía una plantilla de WhatsApp a un teléfono y crea el contacto y la conversación si no existen.
Plantillas en conversaciones. POST /conversations/{conversation_id}/messages acepta type: "template".
Seguimiento de envíos. Los envíos responden 202 con un envío. GET /sends/{send_id} informa si el proveedor lo aceptó y, cuando lo aceptó, el message_id del mensaje.
Filtros de contactos. GET /contacts filtra por query, tag_id, owner_user_id, lifecycle_stage y channel.
Catálogos. GET /channels lista los canales conectados. GET /contact-fields lista los campos personalizados que usan las claves de custom_values.
Webhooks. El campo data de cada evento trae conversation_id y, en los eventos message.*, message_id.