> ## Documentation Index > Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt > Use this file to discover all available pages before exploring further. # Leer schedule pending de una conversación > Retorna el schedule activo (`status=pending`) de la conversación. `data: null` si la conversación existe pero no tiene schedule pending. La conversación debe pertenecer al business del token. ## OpenAPI ````yaml /openapi.json get /{slug}/conversation/scheduled-message openapi: 3.1.0 info: title: 1TO1 AI Public API version: 0.2.0 description: >- API pública de 1TO1 AI para integraciones externas (n8n, CRMs, scripts). Auth via Bearer token. Rate limit 60 req/min por API key. Contrato REST puro: el body de éxito es el payload directo (status HTTP como señal), errores retornan `{code, message}` con ambos campos garantizados. Ver schema `PublicError`. servers: - url: https://app.1to1.ai/api/v1/public description: Producción security: - bearerAuth: [] paths: /{slug}/conversation/scheduled-message: get: tags: - Schedules summary: Leer schedule pending de una conversación description: >- Retorna el schedule activo (`status=pending`) de la conversación. `data: null` si la conversación existe pero no tiene schedule pending. La conversación debe pertenecer al business del token. parameters: - $ref: '#/components/parameters/SlugPathParam' - schema: type: string format: uuid description: Fallback — los CRMs externos normalmente no lo conocen. required: false description: Fallback — los CRMs externos normalmente no lo conocen. name: uuid in: query - schema: type: string description: BSUID de WhatsApp (estándar post-junio 2026). required: false description: BSUID de WhatsApp (estándar post-junio 2026). name: whatsapp_user_id in: query - schema: type: string example: ana.perez description: >- Username público de WhatsApp. Se normaliza (quita `@`, minúsculas). required: false description: Username público de WhatsApp. Se normaliza (quita `@`, minúsculas). name: username in: query - schema: type: string example: +52 55 1234 5678 description: Teléfono E.164. Se normaliza a dígitos. required: false description: Teléfono E.164. Se normaliza a dígitos. name: phone in: query responses: '200': description: Schedule pending o null si no hay. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/ScheduleGetResponse' examples: humanMessage: summary: >- Humano programado como `message` (intent === outcome, ventana abierta al firing) value: data: uuid: aaaa1111-2222-3333-4444-555566667777 executor_kind: human_user schedule_at: '2026-06-15T20:30:00.000Z' status: pending author_snapshot: type: api_token uuid: tttt0000-1111-2222-3333-444455556666 name: CRM externo message_kind: message message_snapshot: kind: message data: text: ¿Pudiste ver la propuesta? media: null template_snapshot: null fired_at: null cancelled_at: null cancel_reason: null failure_reason: null created_at: '2026-06-10T18:00:00.000Z' updated_at: '2026-06-10T18:00:00.000Z' humanQuickReplyDeliveredAsFallback: summary: >- Divergencia post-firing: `quick_reply` programado, ventana cerró, se envió template fallback value: data: uuid: bbbb2222-3333-4444-5555-666677778888 executor_kind: human_user schedule_at: '2026-06-15T20:30:00.000Z' status: executed author_snapshot: type: api_token uuid: tttt0000-1111-2222-3333-444455556666 name: CRM externo message_kind: template message_snapshot: kind: quick_reply data: uuid: qrqr0000-1111-2222-3333-444455556666 name: Saludo bienvenida actions: - type: text-only text: Hola, gracias por escribirnos template_snapshot: template_uuid: tplt0000-1111-2222-3333-444455556666 name: 1to1_default_scheduled_v1 language: es variables: [] header: null button_parameters: [] fired_at: '2026-06-16T20:30:05.000Z' cancelled_at: null cancel_reason: null failure_reason: null created_at: '2026-06-10T18:00:00.000Z' updated_at: '2026-06-16T20:30:05.000Z' noPendingSchedule: summary: Conversación sin schedule pending value: data: null '400': description: Query inválida (INVALID_REQUEST). headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '401': description: Token ausente, mal formado o no válido (INVALID_API_TOKEN) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '403': description: >- El slug del path no coincide con el business del token (TOKEN_BUSINESS_MISMATCH) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '404': description: Conversación no resuelve (CONVERSATION_NOT_FOUND). headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '409': description: >- El identificador de conversación es ambiguo: varios contactos comparten el teléfono (`PHONE_NUMBER_AMBIGUOUS`) o el username (`USERNAME_AMBIGUOUS`). Identifica la conversación por `whatsapp_user_id` o `uuid`. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '429': description: >- Rate limit excedido (RATE_LIMIT_EXCEEDED). Headers `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` indican cuándo reintentar. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '500': description: Error inesperado del servidor (UNKNOWN_ERROR) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' components: parameters: SlugPathParam: schema: $ref: '#/components/schemas/SlugPathParam' required: true description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. name: slug in: path schemas: ScheduleGetResponse: type: object properties: data: description: >- Shape público del schedule. Top-level: `uuid`, `executor_kind`, `schedule_at`, `status`, `author_snapshot`, `template_snapshot`, `fired_at`, `cancelled_at`, `cancel_reason`, `failure_reason`, `created_at`, `updated_at`. Rama AI: `reason`. Rama humana: `message_kind`, `message_snapshot` (envelope `{ kind, data }`). PKs internos (`id`, `business_id`, `thread_id`, `conversation_id`, `*_id` numéricos) y `schedule_id` se filtran del wire. `null` si no hay schedule pending en la conversación. **Importante — `message_kind` vs `message_snapshot.kind`:** `message_kind` refleja el **outcome del firing** (qué se envió efectivamente al destinatario). Post-firing exitoso del fallback template fuera de ventana 24h, la columna se sobrescribe a `'template'` aunque el operador haya programado originalmente `'quick_reply'` o `'message'`. La **intención original** queda preservada en `message_snapshot.kind` (JSONB inmutable). **Para discriminar el shape de `message_snapshot.data` (parsing tipado) usar SIEMPRE `message_snapshot.kind`, nunca `message_kind`** — los dos pueden divergir post-firing. Ver el ejemplo `humanQuickReplyDeliveredAsFallback` que muestra la divergencia. PublicError: type: object properties: code: type: string example: INVALID_API_TOKEN message: type: string example: >- The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token. required: - code - message description: >- Public API error body. The client should match against `code` (stable canonical identifier) and NOT against `message` (human text, may be refined between API versions without notice). The HTTP status code is the error-type signal (4xx client, 5xx server). SlugPathParam: type: string example: acme description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_1to1_ description: >- API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_... ````