Upnify Documentación API
Inicia aquí · /integraciones/calendario/cita

Integraciones

Crear una cita desde un calendario

POST/integraciones/calendario/cita

Crea una cita para un contacto ya registrado y un ejecutivo configurado en el widget. Utiliza tkProspecto obtenido al registrar el contacto y los horarios devueltos por el calendario. La operación puede enviar notificaciones y avanzar el turno de atención del widget. No ofrece una clave de deduplicación: antes de reintentar una respuesta incierta, verifica si se creó la cita. El éxito devuelve un objeto con tkCita; los errores pueden devolver un objeto con msg o un arreglo con code y msg.

Parámetros

NombreTipoValidaciónDescripción
tokenStringRequeridoCuerpo: Token de integración utilizado para consultar la agenda. Se envía en el cuerpo, no solo en el encabezado.
tkWidgetStringRequeridoCuerpo: Identificador del widget de calendario.
tkProspectoStringRequeridoCuerpo: Identificador del contacto al que se vinculará la cita.
tkUsuarioStringRequeridoCuerpo: Identificador del ejecutivo devuelto al consultar los horarios.
fechaInicioStringRequeridoCuerpo: Fecha y hora de inicio; usa un valor ISO 8601 y la zona del horario elegido.
fechaFinStringRequeridoCuerpo: Fecha y hora de fin del horario elegido.
updatedBooleanCuerpo: Indica si el registro del contacto devolvió updated: true; puede influir en el ejecutivo asignado.
gmtNumberCuerpo: Ajuste de zona horaria enviado a la cita. Conserva el valor correspondiente al horario seleccionado.

Respuesta

NombreTipoDescripción
ejecutivoStringNombre del ejecutivo asignado.
asuntoStringAsunto configurado para la cita.
tkCitaStringIdentificador de la cita creada.

Solicitud

Reservar un horario para un contacto

curl --request POST \
  --url https://api.upnify.com/integraciones/calendario/cita \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "token": "P01AP00000000-0000-4000-8000-000000000001",
  "tkWidget": "W-00000000-0000-4000-8000-000000000001",
  "tkProspecto": "P-00000000-0000-4000-8000-000000000001",
  "tkUsuario": "U-00000000-0000-4000-8000-000000000001",
  "fechaInicio": "2026-10-05T10:00:00-05:00",
  "fechaFin": "2026-10-05T10:30:00-05:00",
  "updated": false,
  "gmt": 0
}'

Respuesta

Cita creada (HTTP 200)

JSON
{
  "ejecutivo": "Persona de ejemplo",
  "asunto": "Consulta de información",
  "tkCita": "C-00000000-0000-4000-8000-000000000001"
}

Falta el contacto (HTTP 200)

JSON
{
  "msg": "No se pudo generar el prospecto"
}