Enviar confirmación o recordatorio de cita

Envía una notificación al paciente por WhatsApp usando una plantilla aprobada por Meta, referenciada por templateId.

• Úsalo para enviar la confirmación de cita justo después de agendar.
• Úsalo también para enviar el recordatorio antes del día de la cita.
• Las plantillas y sus variables se configuran en el panel de Omniloy.

POST /whatsapp/messages/template

cURL

confirmacion

curl --request POST \
  --url https://{your-prod-endpoint}/whatsapp/messages/template \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "phoneNumber": "[phone]",
  "templateId": "2f3f8e64-2a1d-4b73-b7e4-9f0a7d6f8e10",
  "params": [
    "Dr. García",
    "martes 15 de julio",
    "11:00",
    "Cardiología - Centro Norte"
  ]
}
'

202

{
  "messageId": "<string>"
}

Autorizaciones

X-Api-Key · string · header · requerido

API Key proporcionada por Omniloy. La misma key se usa para llamadas entrantes y salientes.

Cuerpo

application/json

Notificación por plantilla de WhatsApp referenciada por UUID.

phoneNumber · string · requerido

Número E.164 del destinatario.

templateId · string<uuid> · requerido

UUID de la plantilla aprobada por Meta.

params · string[]

Valores (en orden) para las variables de la plantilla.

mediaUrl · string<uri>

URL de media opcional.

Respuesta

202

application/json

Notificación aceptada para envío

Respuesta al enviar notificación.

messageId · string

ID interno.

status · enum<string>

Estado inicial.

Opciones disponibles: queued, sent