Skip to main content

​
Introducción

Todos los endpoints de notificación de Lovi admiten la programación para entrega futura. Esta función te permite enviar notificaciones en los momentos óptimos teniendo en cuenta las zonas horarias de los destinatarios y el horario comercial.

​
📅 Parámetros de Programación

Tanto las notificaciones de WhatsApp como las de Voz admiten los siguientes parámetros de programación:

​
Parámetros

ParámetroTipoRequeridoDescripciónEjemplo
datetime_sendingDateTimeNoFecha/hora programada en formato ISO 8601"2024-12-25T10:30:00"
timezoneStringNoZona horaria para la hora programada"Europe/Madrid"
Comportamiento Predeterminado: Si no se proporciona datetime_sending, la notificación se envía inmediatamente.

​
🕐 Formato de Fecha y Hora

​
Formatos ISO 8601 Admitidos

{
  "datetime_sending": "2024-12-25T10:30:00",
  "timezone": "Europe/Madrid"
}
Formatos alternativos: 
"2024-12-25T10:30:00"
"2024-12-25T10:30:00.000"
"2024-12-25T10:30:00Z"
"2024-12-25T10:30:00+01:00"

​
Notas Importantes

  • Se requiere fecha futura: La fecha y hora deben ser posteriores a la hora actual
  • ISO 8601 estricto: Usa el formato estándar ISO 8601
  • Zona horaria recomendada: Especifica siempre la zona horaria para mensajes programados
  • UTC por defecto: Si se omite la zona horaria, se usa UTC

​
🌍 Zonas Horarias Admitidas

​
Zonas Horarias Comerciales Comunes

Región/PaísCódigo de Zona HorariaDescripción
EspañaEurope/MadridHora de Europa Central
MéxicoAmerica/Mexico_CityHora Estándar Central
ArgentinaAmerica/Argentina/Buenos_AiresHora de Argentina
ColombiaAmerica/BogotaHora de Colombia
ChileAmerica/SantiagoHora Estándar de Chile
PerúAmerica/LimaHora de Perú
EcuadorAmerica/GuayaquilHora de Ecuador
VenezuelaAmerica/CaracasHora de Venezuela
Estados UnidosAmerica/New_YorkHora Estándar del Este
Estados UnidosAmerica/ChicagoHora Estándar Central
Estados UnidosAmerica/DenverHora Estándar de Montaña
Estados UnidosAmerica/Los_AngelesHora Estándar del Pacífico
UTCUTCTiempo Universal Coordinado

​
Zonas Horarias Europeas

PaísCódigo de Zona HorariaDescripción
Reino UnidoEurope/LondonHora del Meridiano de Greenwich
FranciaEurope/ParisHora de Europa Central
AlemaniaEurope/BerlinHora de Europa Central
ItaliaEurope/RomeHora de Europa Central
Países BajosEurope/AmsterdamHora de Europa Central
PortugalEurope/LisbonHora de Europa Occidental

​
📋 Ejemplos

​
Notificación de WhatsApp Programada

Envío inmediato (sin programación): 
{
  "contact": {
    "number": "34666033135",
    "name": "Ana García"
  },
  "language_template": "es_ES",
  "name_template": "promocion_navidad",
  "recipient_id": "34666033135",
  "notification_type": "marketing",
  "campaign_name": "Campaña de Navidad"
}
Programado para un momento específico: 
{
  "contact": {
    "number": "34666033135",
    "name": "Ana García"
  },
  "language_template": "es_ES",
  "name_template": "promocion_navidad",
  "recipient_id": "34666033135",
  "notification_type": "marketing",
  "campaign_name": "Campaña de Navidad",
  "datetime_sending": "2024-12-24T09:00:00",
  "timezone": "Europe/Madrid"
}

​
Notificación de Voz Programada

{
  "contact": {
    "number": "34666033135",
    "first_name": "María",
    "last_name": "González"
  },
  "recipient_id": "34911670470",
  "agent_id": "uuid-agente-voz",
  "notification_type": "marketing",
  "campaign_name": "Campaña de Voz",
  "datetime_sending": "2024-12-26T10:00:00",
  "timezone": "Europe/Madrid"
}

​
⚙️ Reglas de Validación

​
Validación de Fecha

  • ✅ Solo fechas futuras: Deben ser posteriores a la hora actual
  • ✅ Máximo de anticipación: Hasta 1 año de anticipación
  • ✅ Formato estricto: Debe seguir ISO 8601
  • ❌ Fechas pasadas: Serán rechazadas
  • ❌ Formato inválido: Fechas no ISO serán rechazadas

​
Validación de Zona Horaria

  • ✅ Códigos IANA válidos: Usa la base de datos estándar de zonas horarias
  • ✅ Sensible a mayúsculas: Se requiere el formato exacto
  • ❌ Abreviaciones: No uses CET, EST, etc.
  • ❌ Códigos inválidos: Zonas horarias desconocidas serán rechazadas

​
🚀 Mejores Prácticas

​
Horarios Óptimos

Mensajes de WhatsApp:
  • Horario comercial: 9:00 - 18:00 hora local
  • Evitar muy temprano/tarde: Ni antes de las 8:00 ni después de las 21:00
  • Consideración de fines de semana: Ajustar según las preferencias del fin de semana
  • Conciencia de festivos: Consultar los festivos locales
Llamadas de Voz:
  • Solo en horario comercial: 9:00 - 17:00 hora local
  • Preferir días laborables: De lunes a viernes
  • Horas de comida: Evitar de 14:00 a 16:00
  • Sensibilidad cultural: Respetar las costumbres locales

​
Estrategia de Zona Horaria

  1. Almacenar zonas horarias de usuarios: Guardar la zona horaria preferida por contacto
  2. Mostrar hora local: Mostrar las horas en la zona horaria local del usuario
  3. Lógica de horario comercial: Calcular los tiempos de envío óptimos
  4. Horario de verano: Los códigos IANA gestionan el DST automáticamente

​
⚠️ Errores Comunes

​
Error de Fecha Pasada

{
  "error": "validation_failed",
  "message": "La hora programada debe ser en el futuro",
  "details": {
    "field": "datetime_sending",
    "provided": "2024-12-20T10:00:00",
    "current_time": "2024-12-20T15:30:00Z"
  }
}

​
Error de Zona Horaria Inválida

{
  "error": "validation_failed",
  "message": "Zona horaria especificada inválida",
  "details": {
    "field": "timezone",
    "provided": "CET",
    "suggestion": "Usa códigos de zona horaria IANA como 'Europe/Madrid'"
  }
}