Comment gérer les messages programmés via l'API

Avec l'API REST de Papo (https://papo.global/), vous automatisez la création, le listage et l'annulation des messages programmés pour WhatsApp et SMS, en intégrant la programmation des communications directement à vos systèmes, CRM ou flux d'automatisation — sans avoir à accéder manuellement au panneau.

La plateforme Papo propose déjà un espace centralisé pour gérer les messages programmés, mais lorsque le volume de programmations est élevé ou que vous avez besoin qu'un autre logiciel déclenche les envois, l'API est la solution. Avec elle, il est possible de créer des rappels, des relances et des notifications de manière programmatique, en conservant le même contrôle que dans l'interface visuelle.

Résumé des opérations de messages programmés via l'API

Opération	Ce qu'elle fait	Quand l'utiliser
Créer une programmation	Programme un message WhatsApp ou SMS pour un contact à une date et une heure spécifiques.	Programmer des rappels de rendez-vous, des relances commerciales ou des notifications de recouvrement à partir d'un système externe.
Lister les programmations	Retourne tous les messages programmés, avec la possibilité de filtrer par statut (en attente, envoyé, annulé, échec).	Synchroniser l'agenda des envois avec un tableau de bord, vérifier les éléments en attente avant de créer de nouvelles programmations ou auditer les communications programmées.
Annuler une programmation	Annule un envoi programmé avant l'heure de déclenchement.	Interrompre un message qui n'est plus pertinent, comme un rappel d'événement annulé ou une relance devenue inutile.

Comment fonctionne l'intégration

L'API de Papo suit le standard REST et utilise une authentification par token Bearer. Toutes les opérations d'écriture (création et annulation) nécessitent la clé secrète de votre compte, générée dans l'espace développeur du panneau. L'URL de base est https://app.papo.global/api/v1.

Pour utiliser les fonctionnalités de messages programmés :

Générez une clé secrète dans le panneau Papo (espace développeur/API). Conservez-la en lieu sûr — elle n'est affichée qu'une seule fois.
Dans chaque requête, incluez l'en-tête Authorization: Bearer {votre_clé_secrète}.
Utilisez les endpoints spécifiques aux messages programmés, conformément à la documentation officielle sur https://papo.global/pt/docs. Vous y trouverez les chemins exacts, les paramètres obligatoires (comme l'ID du contact, le canal, le contenu, la date/l'heure) et des exemples de payload au format JSON.
Pour lister les programmations, vous pouvez appliquer des filtres par statut, ce qui permet de consulter uniquement les envois en attente ou déjà terminés.

L'API reflète le comportement du module Messages programmés de la plateforme : les programmations créées via l'API apparaissent dans la liste du panneau, et toute annulation effectuée via l'API met à jour le statut immédiatement.

À qui s'adresse cette automatisation

Développeurs et équipes informatiques qui doivent intégrer la programmation de messages à leurs propres systèmes, tels que des ERP, des CRM ou des plateformes de prise de rendez-vous.
Revendeurs white label qui souhaitent offrir à leurs clients la possibilité de programmer des envois via l'API, augmentant ainsi la valeur de la solution.
Opérations à fort volume de relances (ventes, recouvrement, confirmation de présence) qui souhaitent automatiser la création de rappels sans intervention manuelle.
Entreprises qui utilisent des flux d'automatisation et déclenchent la création de programmations à partir d'événements dans d'autres outils.

Questions fréquentes

Dois-je avoir le module Messages programmés actif pour utiliser l'API ?

Oui. L'API opère sur la même fonctionnalité que celle disponible dans le panneau. Si le module est disponible dans votre forfait, les endpoints correspondants seront également accessibles.

L'API permet-elle de programmer des messages avec des pièces jointes ou des médias ?

La documentation officielle détaille les types de contenu pris en charge. Actuellement, la programmation via la plateforme est destinée aux messages texte. Consultez la référence de l'API pour vérifier si la prise en charge des médias est disponible au moment de votre intégration.

Comment authentifier les requêtes ?

Utilisez la clé secrète de votre compte Papo comme token Bearer dans l'en-tête Authorization. La clé est générée dans l'espace développeur du panneau.

Puis-je programmer des messages pour plusieurs contacts à la fois ?

L'API permet de créer une programmation par requête. Pour plusieurs contacts, vous pouvez effectuer des appels séquentiels. Vérifiez dans la documentation s'il existe des endpoints par lots pour votre cas d'usage.

Que se passe-t-il si j'essaie d'annuler un message déjà envoyé ?

L'API renverra une erreur, car seules les programmations avec le statut en attente peuvent être annulées. Après le déclenchement, le message ne peut plus être modifié.

Où trouver les clés d'API ?

Dans le panneau Papo, accédez à l'espace développeur ou aux configurations d'API. La clé secrète est affichée au moment de la création ; si vous la perdez, il faudra en générer une nouvelle.