Sign inGet Started

Coexistence WhatsApp

La coexistence connecte le numéro de votre application WhatsApp Business à Bird. Vous continuez à utiliser l’application pour écrire à vos clients, et vous utilisez le même numéro pour les envois API, les automatisations et la boîte de réception Conversations de votre équipe.

Quand utiliser la coexistence

Utilisez la coexistence si votre équipe travaille déjà dans l’application WhatsApp Business et doit continuer à y répondre après la connexion à Bird. Par exemple, votre personnel peut répondre aux clients depuis l’application pendant que vous ajoutez des mises à jour de commande automatisées via API.

Si vous n’avez pas besoin de l’application Business, utilisez la configuration standard du numéro. La coexistence exige un compte existant dans l’application Business et limite le débit API.

La coexistence connecte les numéros enregistrés dans l’application WhatsApp Business, en version 2.24.17 ou ultérieure, comme l’indiquent les exigences de Meta pour la coexistence. Un numéro enregistré dans l’application personnelle WhatsApp ne peut pas être connecté en coexistence. Pour continuer à l’utiliser dans une application, enregistrez-le d’abord dans l’application WhatsApp Business. Pour l’utiliser uniquement avec Bird, supprimez son compte WhatsApp, ce qui efface son historique de discussions dans l’application, puis suivez la configuration standard du numéro. Le numéro ne fonctionne alors plus dans WhatsApp, et Meta peut mettre jusqu’à trois minutes pour le libérer. Consultez Meta indique que le numéro est déjà enregistré.

Limites et changements dans l’application

Les numéros en coexistence ont un débit API fixe de 20 messages par seconde, comme le précisent les limitations de la coexistence selon Meta. Si vous avez besoin d’un débit plus élevé, utilisez un numéro connecté sans coexistence.

Vous pouvez consulter le profil d’entreprise d’un numéro en coexistence dans Bird, mais vous le modifiez dans l’application WhatsApp Business. Meta n’autorise pas la modification du profil de ces numéros via son API : Bird ne peut donc pas mettre à jour le nom, la description, l’adresse, le site web ni la photo. Consultez Les modifications du profil d’entreprise renvoient E15088.

Les messages individuels sont synchronisés entre l’application et Bird. Les messages que vous envoyez via Bird, modèles compris, apparaissent dans l’application, et les réponses des clients apparaissent dans les deux. Lors de la connexion, vous pouvez aussi choisir de partager l’historique de discussions existant. Certaines fonctionnalités de l’application changent :

  • Les discussions de groupe restent dans l’application et ne sont pas synchronisées avec Bird.
  • Les listes de diffusion passent en lecture seule, et vous ne pouvez plus en créer dans l’application.
  • Les messages éphémères et les messages à vue unique sont désactivés dans les discussions individuelles.
  • La configuration dissocie tous les appareils liés à l’application. Vous pouvez ensuite lier à nouveau jusqu’à quatre appareils, par exemple WhatsApp Web. WhatsApp pour Windows et WhatsApp pour Wear OS ne sont pas pris en charge.
  • Sur WhatsApp pour Windows ou WhatsApp pour Wear OS, les messages de votre entreprise affichent un texte de remplacement qui invite le lecteur à les ouvrir sur son appareil principal. Les messages qu’un client envoie depuis l’une de ces applications peuvent arriver dans Bird comme messages non pris en charge avec l’erreur 131060. Lisez-les donc dans l’application WhatsApp Business.

Consultez la comparaison des fonctionnalités et la prise en charge des appareils liés de Meta avant de connecter votre numéro.

Coût

La connexion d’un numéro en coexistence n’entraîne aucun frais supplémentaire.

Les messages que vous envoyez depuis l’application WhatsApp Business restent gratuits selon la tarification de la coexistence de Meta. Bird ne facture pas l’enregistrement de ces messages.

Les messages que vous envoyez via Bird suivent les tarifs de messagerie WhatsApp. Consultez Coûts et facturation pour savoir comment les frais s’appliquent.

Messages envoyés depuis l’application

Lorsque vous envoyez un message depuis l’application WhatsApp Business, Bird l’enregistre comme message sortant avec origin: business_app_echo. L’adresse from est le numéro de votre entreprise, et to correspond au client.

Utilisez origin pour distinguer une réponse envoyée depuis l'application d'un message envoyé via Bird. L'envoi depuis l'application ne met pas en pause les réponses automatiques dans Bird.

Le message API renvoie l'enregistrement complet. Cet exemple abrégé montre la direction, les adresses et l'origine ; ... indique les champs omis.

Exemple de code
{
  "direction": "outbound",
  "from": {
    "phone_number": "+14155550100"
  },
  "to": {
    "phone_number": "+14155550101"
  },
  ...
  "origin": "business_app_echo"
}

Étapes suivantes