Cambiar los avisos de Citas

PATCH

https://app.recurrente.com/api/booking_settings/notifications

PATCH

/api/booking_settings/notifications

curl -X PATCH https://app.recurrente.com/api/booking_settings/notifications \
     -H "X-SECRET-KEY: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "confirmation_request_hours_before": 24,
  "reminder_hours_before": [
    2,
    24
  ],
  "notification_texts": {
    "reminder": "¡Te esperamos! Trae tu toalla."
  }
}'

{
  "confirmation_request_hours_before": 24,
  "reminder_hours_before": [
    2,
    24
  ],
  "notification_texts": {
    "confirmed": "Tu cita ha sido confirmada. ¡Gracias por elegirnos!",
    "confirmation_request": "Por favor confirma tu cita para asegurar tu espacio.",
    "reminder": "Recordatorio: tu cita es pronto. ¡No olvides traer todo lo necesario!",
    "rescheduled": "Tu cita ha sido reprogramada. Consulta los detalles en tu cuenta.",
    "cancelled": "Lamentamos informarte que tu cita ha sido cancelada. Contáctanos para más información."
  },
  "free_whatsapp_messages_used": 15,
  "free_whatsapp_messages_per_month": 100
}

Cambia solo lo que envías. confirmation_request_hours_before va de 2 a 168 horas (null no pide confirmación); cada recordatorio, de 1 a 72 horas. En notification_texts, un texto vacío vuelve al nuestro. Un valor inválido responde 422 con code: invalid_booking_settings.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Request

This endpoint expects an object.

confirmation_request_hours_beforeinteger or nullOptional2-168

reminder_hours_beforelist of integersOptional

notification_textsobjectOptional

Los textos que el negocio escribió, por mensaje. Uno que no aparece usa el nuestro.

Response

Los avisos, ya guardados

confirmation_request_hours_beforeinteger or nullOptional

Cuántas horas antes se le pide al cliente confirmar; null si no se pide.

reminder_hours_beforelist of integersOptional

Cuántas horas antes llega cada recordatorio.

notification_textsobjectOptional

Los textos que el negocio escribió, por mensaje. Uno que no aparece usa el nuestro.

free_whatsapp_messages_usedintegerOptional

Mensajes de WhatsApp gratis usados este mes (sin contar los de citas pagadas por Recurrente).

free_whatsapp_messages_per_monthintegerOptional

Errors

422

Unprocessable Entity Error