Le webhook smb_app_state_sync
smb_app_state_sync transporte l’état de l’app WhatsApp Business elle-même, principalement la synchronisation des contacts qui s’exécute lorsqu’un numéro Coexistence se connecte. Il est distinct de history, qui transporte les conversations, et existe uniquement sur les numéros Coexistence.
Champs de synchronisation propres à Coexistence : celui-ci et history.
La fenêtre après l’onboarding pendant laquelle la synchronisation doit commencer.
Équivalent sur un numéro intégré sans Coexistence.
Ce qu’il transporte
L’état côté app, ce qui signifie en pratique les contacts qu’une entreprise avait déjà sur son téléphone.
Chaque contact disposant d’un numéro WhatsApp peut être synchronisé avec la plateforme. Le logiciel peut ainsi reconnaître un client présent depuis des années dans le téléphone de l’entreprise, au lieu de le traiter comme un nouveau numéro. C’est différent des conversations elles-mêmes, qui arrivent dans le champ history : l’un est un annuaire et l’autre une transcription.
Comme history, ce champ existe uniquement sur Coexistence. Il n’y a pas d’état d’app à synchroniser sur un numéro qui n’en a jamais utilisé une.
Ce qu’il ne transporte pas
Les outils de travail propres à l’app, qui n’ont aucune représentation côté plateforme.
- Les étiquettes, qui restent sur l’appareil et ne peuvent pas être lues par un logiciel.
- Les réponses rapides et les messages d’accueil et d’absence.
- Le catalogue, les commandes et le statut.
- Les chaînes, ainsi que l’historique des appels vocaux ou vidéo.
Pourquoi cela compte pour une intégration
Parce que cela détermine si votre système sait qui écrit dès le premier jour.
Sans synchronisation des contacts, chaque message entrant arrive comme un numéro de téléphone sans nom, et c’est à vous de le relier à une fiche client. Avec cette synchronisation, la liste de contacts de l’entreprise est disponible et le rapprochement est en grande partie effectué.
Il vaut mieux prévoir les deux cas : une entreprise peut refuser la synchronisation ou manquer la fenêtre, et une intégration qui suppose que les contacts existent affichera une longue liste de numéros bruts à quiconque l’ouvre.
Erreurs courantes
- Supposer que les contacts seront présents. Une entreprise peut refuser la synchronisation ou manquer sa fenêtre.
- S’attendre à trouver des étiquettes ou des réponses rapides dans ce payload. Elles restent sur l’appareil.
- Le confondre avec history, qui transporte les conversations plutôt que la liste de contacts.
EasyCoexistence s’abonne aux champs opérationnels et enregistre la séquence d’onboarding. Vous voyez ainsi dans sa timeline ce qu’un numéro a synchronisé ou non.
Questions fréquemment posées
Est-ce la même chose que la synchronisation history ?
Non. Ce champ transporte l’état de l’app, principalement les contacts. history transporte les conversations.
Est-ce exécuté plusieurs fois ?
La synchronisation initiale a lieu une seule fois pendant l’onboarding, avec la même fenêtre de 24 heures que history.
Les étiquettes sont-elles disponibles ?
Non. Les étiquettes sont une fonctionnalité de l’app sans équivalent API.
Existe-t-il sur un numéro Cloud API classique ?
Non. Il n’y a pas d’état d’app WhatsApp Business à synchroniser sur un tel 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