Your AI Connector Docs

Fournisseur SMS (Apportez votre propre compte Twilio)

Cette page permet de contrôler le compte Twilio utilisé pour l’API WhatsApp Business. Par défaut, l’API WhatsApp Business fonctionne sur le compte Twilio géré par la plateforme — vous ne voyez jamais Twilio et vous n’avez pas besoin de vous inscrire vous-même sur Twilio. Si vous avez connecté votre propre clé Anthropic (BYOK), les messages WhatsApp via le Twilio géré coûtent 0,05 crédit chacun, entrants et sortants. Sur tous les autres comptes, ces frais de distribution sont déjà couverts par votre tarif de crédits IA, il n’y a donc pas de frais distincts par message. (La tarification des messages de WhatsApp change le 1er octobre 2026 — voir Coûts WhatsApp et le changement d’octobre 2026.) Ceci n’est pertinent que si vous souhaitez spécifiquement que l’API WhatsApp Business fonctionne sur votre propre compte Twilio.

Le SMS nécessite toujours votre propre compte Twilio (Bring Your Own Twilio). La réglementation SMS (A2P 10DLC, enregistrement de marque, approbation de l’ID d’expéditeur) doit être déposée au nom de votre propre entreprise ; la plateforme ne propose donc pas de numéros SMS gérés. Configurez le SMS séparément en utilisant la carte SMS via Twilio dans Paramètres → Canaux (il existe également une option de passerelle SMS pour téléphone Android). Cette page — la carte Compte Twilio — contrôle le compte de l’API WhatsApp Business et ne modifie pas votre numéro SMS.

Pourquoi passer l’API WhatsApp Business sur mon propre compte Twilio ?

La plupart des utilisateurs n’en ont pas besoin. Le compte géré est plus simple :

  • La location de numéros WhatsApp, la soumission de modèles, l’enregistrement de l’expéditeur et la santé des numéros sont tous gérés pour vous. Un numéro loué ici coûte au moins 50 crédits par mois, et cette location inclut la connexion WhatsApp — voir Numéros de téléphone.
  • Il n’y a pas de facture Twilio séparée. Si vous avez connecté votre propre clé Anthropic (BYOK), les messages WhatsApp via le Twilio géré coûtent 0,05 crédit chacun, entrants et sortants. Sur tous les autres comptes, ces frais de distribution sont déjà couverts par votre tarif de crédits IA, il n’y a donc pas de frais distincts par message. Voir Coûts WhatsApp et le changement d’octobre 2026 pour le changement de tarification WhatsApp prévu le 1er octobre 2026.
  • Le support peut aider à déboguer directement les problèmes de distribution.

Vous pourriez vouloir apporter votre propre compte Twilio si :

  • Vous possédez déjà un compte Twilio établi avec des modèles WhatsApp approuvés et des numéros « chauffés » que vous souhaitez continuer à utiliser.
  • Votre entreprise a une raison liée aux achats ou à la conformité de payer Twilio directement.
  • Vous souhaitez une visibilité totale sur l’utilisation et la tarification au niveau de l’opérateur sous-jacent.

Le maintien d’un numéro préchauffé est une tâche en deux étapes. Le changement de compte (ci-dessous) modifie uniquement le compte Twilio que nous utilisons pour l’envoi. Votre numéro WhatsApp existant n’apparaît pas en tant que canal tant que vous ne l’avez pas également associé — voir Associer un numéro WhatsApp que vous possédez déjà. Effectuez ces opérations dans cet ordre.


Comment changer

Comment y accéder : Paramètres → groupe CanauxCanaux, puis recherchez la carte Compte Twilio.

Ce que vous voyez dépend de votre configuration actuelle :

Si vous utilisez le compte géré (par défaut)

Vous verrez une courte explication et un bouton Gérer sur la carte Compte Twilio. Cliquer dessus ouvre le formulaire Passer à votre propre compte Twilio, qui vous demande votre SID de compte et votre Jeton d’authentification Twilio — avec l’avertissement d’action destructive affiché directement dans la boîte de dialogue.

Avant de confirmer, lisez attentivement les avertissements — ce changement est destructif :

  • Tous les numéros que vous avez achetés via la plateforme seront définitivement libérés. Si vous souhaitez continuer à utiliser un numéro, gardez-le dans le compte géré (ne changez pas), ou achetez-le/portez-le d’abord vers votre propre compte Twilio.
  • Les modèles WhatsApp approuvés ne seront pas transférés. Les modèles appartiennent au compte WhatsApp Business qui détient l’expéditeur — vous devrez les soumettre à nouveau sur votre propre compte et attendre une nouvelle approbation.
  • Les discussions et l’historique des messages existants restent visibles, mais les nouvelles réponses sur les numéros libérés échoueront (le numéro n’existe plus).
  • Vous pouvez revenir en arrière plus tard, mais vous obtiendrez un nouveau compte géré sans numéros ni modèles — vos anciens ne seront pas récupérés.

Où trouver votre Account SID et votre Auth Token : connectez-vous à la console Twilio sur console.twilio.com. Les deux se trouvent sur le tableau de bord principal, dans le panneau “Account Info”. L’Account SID commence par AC et comporte 34 caractères.

Après avoir saisi les deux valeurs et confirmé, le système :

  1. Valide que les identifiants fonctionnent.
  2. Libère chaque numéro de téléphone géré de Twilio.
  3. Ferme le sous-compte géré.
  4. Enregistre vos identifiants afin que tout futur WhatsApp sortant utilise votre compte. Votre numéro SMS via Twilio connecté séparément est stocké indépendamment et n’est ni libéré ni modifié par ce changement.

Cela peut prendre de quelques secondes à quelques minutes si vous aviez plusieurs numéros.

Si vous utilisez déjà votre propre compte Twilio

La carte affiche votre compte connecté et vous permet de revenir à la configuration gérée.

Le retour à la configuration gérée provisionne un nouveau sous-compte géré. Comme indiqué ci-dessus : cela ne restaure pas les numéros ou les modèles que vous aviez auparavant — vous repartirez de zéro.


Associer un numéro WhatsApp que vous possédez déjà

Une fois que le compte est sur votre propre Twilio, le bouton Connecter WhatsApp sur la carte API WhatsApp Business change ce qu’il propose : l’option gérée devient Via votre compte Twilio, ce qui attache un expéditeur WhatsApp au sein du compte Twilio que vous avez connecté, et l’achat d’un numéro géré n’est plus proposé. C’est intentionnel — acheter un numéro ou effectuer l’inscription Meta créerait un second compte Twilio géré par la plateforme en plus du vôtre, et vos messages seraient alors envoyés depuis un compte tandis que le numéro résiderait dans l’autre.

Avant de commencer

Votre numéro doit déjà être un expéditeur WhatsApp fonctionnel au sein de votre propre compte Twilio :

  • Il est enregistré en tant qu’expéditeur WhatsApp dans Twilio, associé à votre propre compte WhatsApp Business.
  • Twilio indique que cet expéditeur est En ligne.

Cet écran n’enregistre rien. Il ne crée pas d’expéditeur, ne communique pas avec Meta et ne soumet pas votre numéro pour approbation — il connecte un expéditeur qui fonctionne déjà. Si vous n’en avez pas encore, effectuez d’abord la configuration de l’expéditeur WhatsApp dans Twilio.

Étapes

  1. Allez dans Paramètres → groupe CanauxCanaux.
  2. Sur la carte WhatsApp Business API, cliquez sur Associer votre expéditeur.
  3. Saisissez le numéro WhatsApp au format international (par exemple +31612345678), exactement tel qu’il apparaît sur l’expéditeur dans Twilio.
  4. Donnez-lui éventuellement une Étiquette — un nom pour le numéro dans l’application. Si vous laissez ce champ vide, le nom utilisé sera celui de votre profil d’expéditeur Twilio.
  5. Cliquez sur Associer l’expéditeur.

Vous n’avez pas besoin de saisir à nouveau votre SID de compte ou votre jeton d’authentification : nous les possédons déjà grâce au changement de compte.

Ce qui se passe en coulisses

  1. Nous recherchons l’expéditeur correspondant à ce numéro dans votre compte Twilio et vérifions que Twilio l’a bien mis en ligne.
  2. Nous nous assurons qu’un service de messagerie existe dans votre compte et nous dirigeons son webhook entrant vers nous (en en créant un, nommé d’après l’application, si vous n’en avez pas déjà un). C’est également ce qui permet l’envoi de modèles.
  3. Nous lions votre expéditeur à ce service de messagerie.
  4. Nous dirigeons le propre webhook de l’expéditeur vers nous, afin que les messages entrants arrivent ici.
  5. Le numéro apparaît dans votre liste de numéros, marqué Votre Twilio (BYO), prêt à être assigné à une campagne ou à un agent.

Vos modèles approuvés restent exactement là où ils sont, dans votre propre compte. Rien n’est soumis à nouveau et rien n’est libéré.

Coûts

Il n’y a pas de frais de maintenance mensuels pour un numéro que vous associez de cette manière — vous payez Twilio directement pour le numéro et ses frais par message. Les réponses par IA utilisent toujours des crédits normalement.

Si cela ne fonctionne pas

  • « Aucun expéditeur WhatsApp pour … n’existe dans votre compte Twilio » — le numéro n’est pas enregistré en tant qu’expéditeur WhatsApp à cet endroit, ou il est saisi différemment. Vérifiez l’identifiant exact de l’expéditeur dans la console Twilio et saisissez-le à nouveau au format international.
  • « L’expéditeur WhatsApp … n’est pas en ligne dans Twilio » — la raison propre à Twilio est incluse dans le message. Corrigez-la d’abord dans Twilio ; l’ajout d’un expéditeur que Twilio considère comme hors ligne ne ferait qu’échouer plus tard, silencieusement.
  • « … est déjà connecté à un autre compte » — le numéro est rattaché à un compte différent ici. Déconnectez-le d’abord là-bas.
  • « Ce compte est toujours sur le compte Twilio géré » — effectuez d’abord le changement ci-dessus.
  • « nous n’avons pas pu mettre à jour son webhook dans Twilio » — le numéro est rattaché et enverra des messages, mais l’expéditeur pointe toujours vers le webhook que vous aviez configuré. Supprimez ce webhook sur l’expéditeur dans la console Twilio afin que les messages entrants nous parviennent.

Limites

  • Vous pouvez changer de fournisseur au maximum une fois toutes les 24 heures. Cela évite que les rebonds répétés n’entraînent des coûts d’API Twilio et des limites de débit.
  • L’envoi de SMS n’est absolument pas affecté par ce paramètre — si vous avez déjà connecté votre propre Twilio via la carte SMS via Twilio, il s’agit d’une connexion différente qui reste en place, indépendamment de ce que vous faites ici.

Que faire en cas de problème ?

  • « Impossible de s’authentifier avec les identifiants Twilio fournis » — vérifiez le SID (commence par AC, 34 caractères) et le jeton d’authentification. Les deux sont sensibles à la casse.
  • « Le compte n’est pas actif » — le compte Twilio que vous essayez d’utiliser est suspendu ou fermé. Utilisez un compte actif.
  • « Veuillez patienter Xh avant de changer à nouveau » — vous êtes dans la période de refroidissement de 24 heures. Veuillez patienter.
  • Migration partielle (certains numéros libérés, d’autres non) — relancez le changement. Le système est idempotent ; il reprend là où il s’est arrêté et termine la libération de tout ce qui se trouve encore dans le sous-compte géré.

Si vous rencontrez des difficultés après le changement — les messages sortants ne sont pas envoyés, les modèles n’apparaissent pas — contactez le support avec votre SID de compte (jamais le jeton d’authentification).


Besoin d’aide ?

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.