Programmation et gestion des fuseaux horaires

Documentation Index

Fetch the complete documentation index at: https://docs.lovi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Introduction

​

📅 Paramètres de programmation

​

Paramètres

​

🕐 Format datetime

​

Formats ISO 8601 supportés

{
  "datetime_sending": "2024-12-25T10:30:00",
  "timezone": "Europe/Madrid"
}

"2024-12-25T10:30:00"
"2024-12-25T10:30:00.000"
"2024-12-25T10:30:00Z"
"2024-12-25T10:30:00+01:00"

​

Notes importantes

• Date future requise : La date doit être dans le futur
• ISO 8601 strict : Utilisez le format standard ISO 8601
• Fuseau horaire recommandé : Spécifiez toujours le fuseau horaire pour les messages programmés
• UTC par défaut : Si le fuseau horaire est omis, UTC est utilisé

​

🌍 Fuseaux horaires supportés

​

Fuseaux horaires professionnels courants

​

Fuseaux horaires européens

​

📋 Exemples

​

Notification WhatsApp programmée

{
  "contact": {
    "number": "34666033135",
    "name": "Ana García"
  },
  "language_template": "es_ES",
  "name_template": "promocion_navidad",
  "recipient_id": "34666033135",
  "notification_type": "marketing",
  "campaign_name": "Christmas Campaign"
}

{
  "contact": {
    "number": "34666033135",
    "name": "Ana García"
  },
  "language_template": "es_ES",
  "name_template": "promocion_navidad",
  "recipient_id": "34666033135",
  "notification_type": "marketing",
  "campaign_name": "Christmas Campaign",
  "datetime_sending": "2024-12-24T09:00:00",
  "timezone": "Europe/Madrid"
}

​

Notification vocale programmée

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

​

Structure plate avec programmation (unflatten=true)

{
  "contact.number": "34666033135",
  "contact.name": "Ana García",
  "language_template": "es_ES",
  "name_template": "promocion_navidad",
  "recipient_id": "34666033135",
  "notification_type": "marketing",
  "campaign_name": "Christmas Campaign",
  "datetime_sending": "2024-12-24T09:00:00",
  "timezone": "Europe/Madrid"
}

​

⚙️ Règles de validation

​

Validation des dates

• ✅ Dates futures uniquement : Doit être postérieur à l’heure actuelle
• ✅ Avance maximale : Jusqu’à 1 an à l’avance
• ✅ Format strict : Doit suivre ISO 8601
• ❌ Dates passées : Seront rejetées
• ❌ Format invalide : Dates non-ISO rejetées

​

Validation des fuseaux horaires

• ✅ Codes IANA valides : Utilisez la base de données standard des fuseaux horaires
• ✅ Sensible à la casse : Format exact requis
• ❌ Abréviations : N’utilisez pas CET, EST, etc.
• ❌ Codes invalides : Fuseaux horaires inconnus rejetés

​

Exemples valides/invalides

{
  "datetime_sending": "2024-12-25T14:30:00",
  "timezone": "America/Mexico_City"
}

{
  "datetime_sending": "25/12/2024 14:30",  // Mauvais format
  "timezone": "Europe/Madrid"
}

{
  "datetime_sending": "2024-12-25T14:30:00",
  "timezone": "CET"  // Utilisez Europe/Madrid à la place
}

​

🚀 Bonnes pratiques

​

Timing optimal

• Heures ouvrables : 9h00 - 18h00 heure locale
• Évitez tôt/tard : Pas avant 8h00 ni après 21h00
• Considération week-end : Ajustez selon les préférences du week-end
• Sensibilité aux jours fériés : Vérifiez les jours fériés locaux

• Heures ouvrables uniquement : 9h00 - 17h00 heure locale
• Jours ouvrés préférés : Du lundi au vendredi
• Heures de déjeuner : Évitez 12h00 - 14h00
• Sensibilité culturelle : Respectez les coutumes locales

​

Stratégie de fuseaux horaires

1. Stockez les fuseaux horaires des utilisateurs : Enregistrez le fuseau horaire préféré par contact
2. Affichage en heure locale : Affichez les heures dans le fuseau horaire local de l’utilisateur
3. Logique d’heures ouvrables : Calculez les heures d’envoi optimales
4. Heure d’été : Les codes IANA gèrent automatiquement le changement d’heure

​

Flux de programmation

​

📊 Exemples de réponse

​

Programmation réussie

{
  "success": true,
  "message": "Notification scheduled successfully",
  "notification_id": "uuid-notification-123",
  "scheduled_time": "2024-12-25T10:30:00Z",
  "local_time": "2024-12-25T11:30:00+01:00",
  "timezone": "Europe/Madrid"
}

​

Envoi immédiat

{
  "success": true,
  "message": "Notification queued for immediate sending",
  "notification_id": "uuid-notification-456",
  "queued_at": "2024-12-20T15:45:30Z"
}

​

⚠️ Erreurs courantes

​

Erreur de date passée

{
  "error": "validation_failed",
  "message": "Scheduled time must be in the future",
  "details": {
    "field": "datetime_sending",
    "provided": "2024-12-20T10:00:00",
    "current_time": "2024-12-20T15:30:00Z"
  }
}

​

Erreur de fuseau horaire invalide

{
  "error": "validation_failed",
  "message": "Invalid timezone specified",
  "details": {
    "field": "timezone",
    "provided": "CET",
    "suggestion": "Use IANA timezone codes like 'Europe/Madrid'"
  }
}

​

Erreur de format invalide

{
  "error": "validation_failed",
  "message": "Invalid datetime format",
  "details": {
    "field": "datetime_sending",
    "provided": "25-12-2024 10:30",
    "expected_format": "ISO 8601 (YYYY-MM-DDTHH:MM:SS)"
  }
}

​

🛠️ Conseils de développement

​

Test de la programmation

1. Utilisez le futur proche : Testez avec des heures 5-10 minutes en avance
2. Test des fuseaux horaires : Testez différents scénarios de fuseaux horaires
3. Cas limites : Testez les transitions d’heure d’été
4. Gestion des erreurs : Testez avec des dates/fuseaux horaires invalides

​

Considérations pour la production

• Temps tampon : Ajoutez 2-3 minutes de tampon pour le traitement
• Surveillance : Surveillez les heures d’envoi programmées vs réelles
• Logique de retry : Gérez les échecs temporaires gracieusement
• Journaux : Journalisez les détails de programmation pour le débogage

​

Ressources fuseaux horaires

• Base de données IANA : Base de données officielle des fuseaux horaires
• Convertisseur en ligne : Utilisez des outils pour vérifier les codes de fuseaux horaires
• Documentation : Gardez une référence des fuseaux horaires pour les développeurs