Le webhook history
history transporte le transfert unique des conversations existantes d'un numéro Coexistence vers l'API. Il arrive après l'onboarding lorsque le partage de l'historique a été accepté, et c'est le seul signal indiquant à une intégration que le transfert a bien eu lieu.
La fenêtre après l'onboarding pendant laquelle la synchronisation doit démarrer.
L'erreur renvoyée lorsque la synchronisation a déjà été utilisée.
L'erreur renvoyée lorsqu'elle est tentée en dehors de cette fenêtre.
Ce qu'il fournit
L'historique des messages individuels déjà présents dans l'application WhatsApp Business d'un numéro est transféré, afin que le logiciel ne démarre pas à l'aveugle sur une ligne utilisée par une entreprise depuis des années.
Les conversations de groupe ne sont pas transférées. Elles sont entièrement exclues de l'API pour un numéro Coexistence. Les outils propres à l'application, comme les libellés, les réponses rapides et les messages d'accueil et d'absence, n'ont pas d'équivalent dans l'API et restent sur l'appareil.
Ce champ existe uniquement pour les numéros Coexistence. Un numéro intégré par la voie ordinaire n'a pas d'historique antérieur dans l'application à transférer, donc il n'y a rien à fournir.
Pourquoi est-il déclenché une seule fois
Parce que le transfert fait partie de l'onboarding et non d'une fonctionnalité continue.
Pendant Embedded Signup, le propriétaire de l'entreprise doit indiquer s'il souhaite partager les conversations existantes. Répondre oui permet à la synchronisation de s'exécuter. Aucun paramètre ne permet ensuite de la réactiver, et aucun endpoint ne permet de la répéter. Une deuxième tentative renvoie 2593107, et non une limite de débit qui finirait par disparaître.
Il existe aussi une date limite. La synchronisation doit démarrer dans les 24 heures suivant l'onboarding. Toute tentative ultérieure renvoie 2593108. Si l'une de ces conditions n'est pas respectée, il faut déconnecter le numéro et reprendre tout le parcours.
Ce qu'un gestionnaire doit en faire
Traitez-le comme un lot reçu une seule fois, potentiellement volumineux, plutôt que comme du trafic supplémentaire sur le chemin des messages.
- Accusez rapidement réception et traitez-le de façon asynchrone, comme toute autre livraison.
- Dédupliquez sur message id : l'historique et les messages en direct peuvent se chevaucher au moment de l'onboarding.
- Attendez-vous à son absence. Un numéro dont le propriétaire a refusé l'historique n'envoie rien ici, et l'intégration doit fonctionner dans les deux cas.
- Ne bloquez pas l'onboarding en l'attendant. La connexion est utilisable avant la fin du transfert.
Erreurs courantes
- Construire une intégration qui exige la présence de l'historique. De nombreux numéros se connectent sans lui.
- Relancer la synchronisation après 2593107. Il s'agit d'un événement unique, donc la relance renvoie la même erreur.
- Attendre le début du travail d'intégration pour décider du transfert de l'historique, ce qui survient généralement après la fermeture de la fenêtre de 24 heures.
EasyCoexistence enregistre l'onboarding et le choix concernant l'historique dans la timeline de connexion. La synchronisation d'un numéro et sa date deviennent ainsi des faits datés, plutôt qu'un élément à reconstituer plus tard.
Questions fréquemment posées
Quelle quantité d'historique est transférée ?
Une période de conversations individuelles récentes, définie par Meta et non par un fournisseur.
Les conversations de groupe sont-elles transférées ?
Non. Les groupes sont entièrement exclus de l'API pour un numéro Coexistence.
Puis-je le demander à nouveau plus tard ?
Non. Il s'exécute une fois par onboarding. Le relancer nécessite de déconnecter puis de reconnecter le numéro.
Que se passe-t-il si le propriétaire refuse l'historique ?
Rien n'arrive dans ce champ, et l'API ne reçoit que les messages envoyés à partir de la connexion du numéro.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le