> ## Documentation Index
> Fetch the complete documentation index at: https://docs.impulsodigital.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Programar un mensaje

> Un texto o una plantilla para una fecha (entre 1 minuto y 30 días adelante). Sale por la misma cola del panel:
respeta el horario de la cuenta, se cancela si el cliente responde antes y, si la ventana de 24 h está cerrada,
usa la plantilla de respaldo.




## OpenAPI

````yaml /openapi.yaml post /scheduled
openapi: 3.1.0
info:
  title: API de Impulso Digital
  version: '1.0'
  description: >
    Conecta tu CRM, tu tienda o un asistente de IA a una cuenta de Impulso
    Digital: envía mensajes y plantillas por WhatsApp, lee conversaciones,
    maneja contactos y mensajes programados, y recibe avisos (webhooks) de lo
    que pasa en la cuenta.
  contact:
    name: Impulso Digital
    url: https://impulsodigital.app
    email: soporte@impulsodigital.app
servers:
  - url: https://api.impulsodigital.app/v1
    description: Producción
security:
  - llave: []
tags:
  - name: Cuenta
  - name: Mensajes
  - name: Conversaciones
  - name: Contactos
  - name: Plantillas
  - name: Programados
  - name: Avisos
paths:
  /scheduled:
    post:
      tags:
        - Programados
      summary: Programar un mensaje
      description: >
        Un texto o una plantilla para una fecha (entre 1 minuto y 30 días
        adelante). Sale por la misma cola del panel:

        respeta el horario de la cuenta, se cancela si el cliente responde antes
        y, si la ventana de 24 h está cerrada,

        usa la plantilla de respaldo.
      parameters:
        - $ref: '#/components/parameters/IdempotencyKey'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - conversation_id
                - send_at
              properties:
                conversation_id:
                  type: string
                send_at:
                  type: string
                  format: date-time
                  examples:
                    - '2026-11-20T09:00:00-05:00'
                text:
                  type: string
                  description: Texto (o `template_id`
                  uno de los dos).: null
                template_id:
                  type: string
                fallback_template_id:
                  type: string
                cancel_on_reply:
                  type: boolean
                  default: true
      responses:
        '201':
          description: Programado
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      conversation_id:
                        type: string
                      send_at:
                        type: string
                        format: date-time
                      status:
                        type: string
components:
  parameters:
    IdempotencyKey:
      name: Idempotency-Key
      in: header
      description: >-
        Identificador tuyo para que un reintento no se procese dos veces (24 h,
        hasta 200 caracteres).
      schema:
        type: string
        maxLength: 200
  securitySchemes:
    llave:
      type: http
      scheme: bearer
      description: >-
        Tu llave de API: `Authorization: Bearer imp_live_…`. También se acepta
        la cabecera `X-API-Key`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.