You are viewing the French site, but your language preference is set to English. Switch to English site →

Menu

Expand
Rate this page:

Twilio Channels

Bêta publique

Certains Twilio Channels sont actuellement disponibles en version bêta publique. Cela signifie que certaines fonctionnalités ne sont pas encore implémentées et d'autres peuvent être modifiées avant que le produit ne soit déclaré comme étant disponible.

Les produits bêta publics ne sont pas couverts par un SLA Twilio.

Les Channels sont l'ensemble des intégrations tierces qui vous permettent d'envoyer et de recevoir des messages sur plusieurs canaux avec les API Twilio que vous utilisez déjà. L'utilisation de Channels avec Twilio facilite la communication avec vos clients sur de nouvelles plateformes, telles que Facebook Messenger, WhatsApp, etc.

Les Channels sont disponibles via Twilio Marketplace ; vous pouvez choisir parmi une liste de Channels vérifiés et les installer en un seul clic. Une fois installés, ils vous permettent d'envoyer et de recevoir des messages avec d'autres plateformes de communication à l'aide de l'API Twilio.

Produits pris en charge

Les Twilio Channels sont actuellement pris en charge par Programmable Messaging et Notify. Cliquez ici pour installer des Channels spécifiques ou demander l'accès aux Channels en aperçu développeur.

Channels dans la version bêta publique :
Facebook Messenger

Conditions de service

Les Channels sont fournis et pris en charge par les fournisseurs de Channels sur Twilio Marketplace. Dans le cadre du processus d'installation des Channels, vous devrez accepter les conditions de service du fournisseur de Channels. Notez que le Channel est fourni en vertu de la politique de confidentialité et des conditions de service du partenaire(Partner's Terms of Service & Privacy policy.). La documentation spécifique au Channel se trouve dans la console, sous la page de catalogue du Channel.

Définition et configuration d'un Channel

Installation d'un Channel

Les premiers pas avec des Channels sont simples. Les Channel disponibles sont répertoriés dans le catalogue des Channels de la console. Pour commencer, cliquez sur le Channel et installez-le. Cela crée une instance du Channel que vous pouvez configurer avec un nom unique et activer pour une utilisation dans un ou plusieurs produits Twilio.

Utilisation de l'API WhatsApp avec Twilio

La prise en charge de l'API WhatsApp Business par Twilio est désormais disponible. Pour commencer, consultez les documents d'API ici.

Authentification avec le fournisseur de Channel et la configuration

Pour pouvoir envoyer et recevoir des messages à partir d'un Channel, vous devez disposer d'un compte configuré sur la plateforme spécifiée. Vous autorisez ensuite Twilio à envoyer et recevoir des messages en votre nom, ce qui permet d'accéder à chaque plateforme via l'API Twilio.

Une fois qu'un Channel est activé, l'étape suivante consiste à authentifier l'instance de Channel auprès du fournisseur de Channel. Cela lie également l'instance de Channel à un endpoint (point de terminaison) spécifique au Channel (comme une page Facebook) au sein de ce même Channel. Les spécificités de ce système varient d'un Channel à l'autre ; veuillez vous reporter à la documentation spécifique au Channel sur la page détaillée du Channel dans la console.

Une fois qu'un Channel est authentifié, vous pouvez désormais le configurer pour qu'il fonctionne avec une API Twilio :

Paramètre de configuration Description
Adresse de Channel I s'agit d'un identifiant unique pour le endpoint de Channel orienté utilisateur, tel qu'une page Facebook. Les adresses de Channel prennent la forme de channel-provider:identifier. Par exemple, l'adresse de Channel d'un Channel Facebook est messenger:<page id>. L'utilisateur final ne peut pas modifier ce paramètre.
URL de rappel Une URL dans laquelle Twilio publiera chaque fois qu'un message est reçu par Twilio. Le format de cette requête est le même que celui de la requête TwiML SMS entrant de Twilio. Les URL non relatives doivent contenir un nom d'hôte valide (les underscores ne sont pas autorisés).
Méthode de rappel Méthode à utiliser avec l'URL de rappel. GET ou POST.
URL de reprise URL de reprise vers laquelle Twilio publiera si l'URL de rappel ci-dessus renvoie une erreur.
Méthode de reprise Méthode à utiliser avec l'URL de reprise. GET ou POST.
URL de rappel de statut Une URL dans laquelle Twilio publiera chaque fois que le statut de votre message sortant passe à l'un des statuts suivants : failed (échec), sent (envoyé). Twilio affiche les paramètres de requête TwiML standard ainsi que les paramètres de statut standard : MessageStatus et ErrorCode.
Les URL non relatives doivent contenir un nom d'hôte valide (les underscores ne sont pas autorisés).
Méthode de rappel de statut Méthode à utiliser avec le rappel de statut. GET ou POST.

Créer plusieurs instances d'un Channel

Twilio prend en charge la création de plusieurs instances d'un Channel afin que votre application puisse utiliser différents endpoints spécifiques au Channel. Par exemple, cela vous permet de prendre en charge l'envoi et la réception de messages depuis plusieurs pages Facebook, en créant et associant chaque page Facebook à une instance du Channel Facebook.

Utiliser le Channel

Vous utilisez les mêmes API de produit Twilio pour envoyer et recevoir des messages des Channels. Il vous suffit de référencer l'adresse de Channel que vous avez configurée lors de l'installation du Channel.

Une fois le Channel configuré, vous devez sélectionner le produit Twilio avec lequel vous souhaitez utiliser le Channel en cochant la case du produit approprié sous « Use In » (Utiliser dans).

Adresses de Channel

Chaque Channel utilise un schéma d'identification unique différent pour traiter les utilisateurs. Le tableau ci-dessous répertorie la manière dont les utilisateurs sont identifiés par chaque Channel pris en charge lorsqu'ils sont utilisés avec les API Twilio. Pour plus de détails sur les endpoints et les adresses d'un Channel donné, reportez-vous à la documentation spécifique au Channel sur la page Documentation accessible depuis la page détaillée du Channel dans la console.

Channel Endpoint de Channel visible par l'utilisateur final Adresse endpoint de Channel Adresse utilisateur de Channel Remarques
Facebook Messenger Page Facebook messenger:{id page} messenger:{id messenger} Un identifiant Messenger est différent d'un identifiant Facebook et est spécifique à l'utilisateur Messenger et à votre page Facebook. Il ne peut être récupéré que lorsque l'utilisateur de Facebook Messenger vous envoie un message.

L'API Whatsapp Business avec Twilio

Consultez le tableau ci-dessous pour connaître le schéma d'adressage de WhatsApp :

Channel Endpoint de Channel visible par l'utilisateur final Adresse endpoint de Channel Adresse utilisateur de Channel Remarques
WhatsApp Numéro de téléphone Business whatsapp:{numéro de téléphone au format e164} whatsapp:{numéro de téléphone au format e164 de l'utilisateur} Voir [ici] (/docs/sms/whatsapp/api) pour commencer à utiliser WhatsApp.

Programmable Messaging

Pour utiliser un Channel avec Twilio Programmable Messaging, vous devez cocher la case « Use In: Programmable SMS Inbound » (Utiliser dans : Programmable SMS entrant).

Envoyer un message

Voir la page API REST : Envoyer un SMS ou un MMS ou API REST : Messages pour plus de détails sur l'utilisation des Channels via les API Programmable Messaging pour envoyer un message.

Voici un exemple de la façon dont vous pouvez envoyer un message à Facebook Messenger à l'aide de Programmable SMS :

curl -X "POST" \
--data-urlencode 'To=messenger:{Messenger User ID}' \
--data-urlencode 'From=messenger:{Facebook Page ID}' \
--data-urlencode 'Body=Voulez-vous jouer à un jeu ?' \
-u {Account Sid}:{Auth Token} \
https://api.twilio.com/2010-04-01/Accounts/{AccountSID}/Messages.json

Recevoir un message

Pour recevoir un message d'un Channel prenant en charge Programmable Messaging, définissez l'URL de rappel sous la section Configuration une fois le Channel installé. Cette URL recevra un rappel au même format que Rappels TwiML de SMS entrant.

Gérer les préférences d'opt-in, opt-out et consommateurs

Tout comme vous êtes tenu de gérer les opt-ins des consommateurs pour vos applications SMS, vous êtes également responsable de la gestion des opt-ins des consommateurs pour les plateformes OTT. Les utilisateurs de votre application doivent explicitement vous accorder l'autorisation de leur envoyer des messages dans chaque canal unique. Par exemple, le consentement à envoyer un message texte à quelqu'un ne vous autorise pas à le contacter via Messenger.

De même, vous devez respecter les consommateurs qui opt-out sur chaque plateforme. Chaque plateforme dispose de sa propre méthode d'opt-out, que Twilio normalisera pour vous autant que possible. Par exemple, les consommateurs peuvent bloquer les SMS pour ne plus recevoir de SMS ou bloquer votre application pour arrêter la messagerie au sein d'un canal OTT. Si un utilisateur choisit un canal de communication, il n'est PAS nécessaire de le retirer de tous les canaux. Vous pouvez traiter chaque consentement et refus de manière indépendante.

Rate this page:

Besoin d'aide ?

Ça arrive à tout le monde, il est difficile de coder. Obtenez de l'aide dès maintenant auprès de notre équipe d'assistance, ou appuyez-vous sur la sagesse collective en visitant les Forums de la communauté Twilio ou en parcourant Twilio tag sur Stack Overflow.

        
        
        

        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more