Talkable
Talkable aide les marques grand public à transformer leurs clients satisfaits en un canal de recommandation évolutif. Grâce à l’intégration avec Braze, les abonnements marketing par e-mail capturés dans les campagnes de recommandation Talkable sont transmis à Braze en temps réel, fournissant à votre équipe le consentement, le contexte et les données de campagne nécessaires pour accueillir, segmenter et engager chaque nouvel ambassadeur et ami.
Cette intégration est maintenue par Talkable.
À propos de l’intégration
Talkable intègre l’acquisition portée par les ambassadeurs dans le parcours client que Braze alimente. L’intégration transfère en temps réel chaque abonnement lié à une recommandation capturé par Talkable vers le profil Braze correspondant, de sorte que les flux de bienvenue, les parcours de recommandation, la segmentation et les messages de cycle de vie puissent s’appuyer sur un consentement vérifié et un contexte de recommandation — le tout sans exports manuels de listes ni synchronisations par lots.
Talkable capture les abonnements marketing dans deux scénarios :
- Inscription de l’ambassadeur : un ambassadeur s’inscrit à une Campaign de recommandation Talkable et consent à recevoir des e-mails marketing.
- Étape d’e-mail gating pour l’ami : un ami complète l’étape d’e-mail gating de Talkable et s’abonne aux e-mails marketing.
Dans les deux cas, Talkable crée ou met à jour le profil utilisateur Braze correspondant en temps réel et définit le statut d’abonnement e-mail de l’utilisateur sur Opted In.
Comportement par défaut
Talkable envoie des données à Braze uniquement lors d’un événement d’abonnement explicite de la part d’une personne ayant donné son consentement dans Talkable — qu’il s’agisse d’un ambassadeur s’inscrivant à une Campaign ou d’un ami s’abonnant lors de l’e-mail gating. Talkable n’exécute pas de traitements par lots nocturnes, de synchronisations complètes ni de mises à jour implicites de profils. Talkable n’envoie jamais à Braze de profils n’ayant pas donné leur consentement.
Cas d’usage
- Déclencher un Canvas de bienvenue Braze dès qu’un ambassadeur s’inscrit à une campagne de recommandation Talkable.
- Activer les amis recommandés avec un Canvas spécifique et une offre personnalisée de premier achat dès qu’un ami s’abonne.
- Segmenter par contexte de recommandation en utilisant les indicateurs d’ambassadeur et d’ami ainsi que les métadonnées de campagne envoyées en tant qu’attributs personnalisés Braze.
- Acheminer les abonnements de recommandation vers un groupe d’abonnement Braze dédié pour un envoi de newsletter conforme à la réglementation.
Prérequis
Avant de commencer, vous avez besoin des éléments suivants :
| Prérequis | Description |
|---|---|
| Un compte Talkable | Un site Talkable avec au moins une campagne configurée est requis pour tirer parti de ce partenariat. |
| Une clé API REST Braze | Une clé API REST Braze avec les permissions users.track. Créez cette clé dans le tableau de bord de Braze depuis Paramètres > Clés API. Pour plus d’informations, consultez Créer des clés API REST. |
| Un endpoint REST Braze | L’URL de votre endpoint REST Braze (par exemple, https://rest.iad-01.braze.com). Les clusters Braze US (.com) et EU (.eu) sont pris en charge. Pour plus d’informations, consultez Endpoints de l’API REST. |
Intégration
Étape 1 : Installer l’application Braze dans Talkable
- Connectez-vous à votre interface d’administration Talkable et ouvrez le menu, puis accédez à All Site Settings > App Store.
- Recherchez Braze et sélectionnez Install.
- Saisissez votre endpoint REST Braze et une clé API REST disposant des permissions
users.track, puis sélectionnez Save.
Étape 2 : Configurer l’action d’abonnement par e-mail
- Dans l’application Braze de Talkable, ouvrez l’action Email opt-in.
- (Facultatif) Saisissez un identifiant de groupe d’abonnement Braze, ajoutez des attributs personnalisés et/ou configurez un alias d’utilisateur. Pour plus d’informations, consultez Personnaliser Talkable.
- Sélectionnez Save. Laissez l’action désactivée afin de pouvoir vérifier la configuration avec un payload de test avant que les événements d’abonnement en direct ne commencent à se synchroniser.
Étape 3 : Tester avec un payload d’exemple
- Dans Talkable, sélectionnez Send sample payload sur l’action Email opt-in pour envoyer une requête de test à Braze.
- Dans Braze, accédez à Audience > Recherche d’utilisateurs et effectuez une recherche par l’adresse e-mail de test.
- Confirmez que le profil existe avec Email Subscribe défini sur Opted In et que tous les attributs personnalisés, l’inscription au groupe d’abonnement ou l’alias d’utilisateur que vous avez configurés apparaissent comme prévu.
Étape 4 : Activer l’action pour le trafic en direct
Lorsque le profil de test semble correct dans Braze, retournez dans Talkable et activez l’action Email opt-in.
À partir de ce moment, chaque événement d’abonnement Talkable synchronise le profil correspondant vers Braze en temps réel.
Attributs utilisateur par défaut envoyés à Braze
À chaque événement d’abonnement, Talkable crée ou met à jour le profil utilisateur Braze correspondant avec les attributs utilisateur standard Braze suivants. Les valeurs vides sont omises.
| Attribut Braze | Type | Notes |
|---|---|---|
email_subscribe |
String | Défini sur Opted In à chaque événement d’abonnement Talkable. |
email |
String | Identifiant principal utilisé pour faire correspondre le profil Braze. |
phone |
String | Capturé uniquement en tant qu’attribut utilisateur. Braze attend le format E.164 ; envoyé tel que stocké dans Talkable. |
first_name |
String | Le prénom de la personne. |
last_name |
String | Le nom de famille de la personne. |
| Inscription au groupe d’abonnement | Non applicable | Talkable inscrit l’utilisateur comme abonné lorsqu’un groupe d’abonnement est configuré. |
| Alias d’utilisateur | Non applicable | Ajouté uniquement lorsqu’un alias d’utilisateur est configuré. Pour plus d’informations, consultez Personnaliser Talkable. |
Personnaliser Talkable
Les personnalisations optionnelles suivantes sont disponibles. Configurez n’importe quelle combinaison ; elles sont indépendantes.
Inscrire les abonnements dans un groupe d’abonnement Braze
- Dans Braze, copiez un ID de groupe d’abonnement depuis Audience > Subscription Group Management. Pour en savoir plus, consultez Gérer les abonnements des utilisateurs.
- Dans l’action Email opt-in de Talkable, collez-le dans le champ Subscription group identifier.
Talkable inscrit chaque abonnement dans ce groupe d’abonnement avec le statut « subscribed », limitant les abonnements de recommandation à ce groupe plutôt qu’à un abonnement global. Talkable ajoute uniquement des abonnements ; il ne les supprime jamais.
Envoyer des attributs personnalisés
Ajoutez n’importe quelle paire clé-valeur dans l’éditeur de payload de l’action. La clé que vous saisissez devient le nom de l’attribut sur le profil utilisateur Braze.
Les valeurs sont formatées avec Liquid. Les variables suivantes sont disponibles :
| Variable | Contenu |
|---|---|
{{ person }} |
L’ambassadeur ou l’ami qui s’est abonné (email, first_name, last_name, phone_number, username, is_advocate, custom_properties, et plus). |
{{ ip }} |
L’adresse IP à partir de laquelle l’abonnement a eu lieu. |
{{ campaign }} |
La Campaign Talkable d’origine (name, type, tag_names, et plus). |
Exemple : ajoutez talkable_is_advocate = {{ person.is_advocate }} et talkable_campaign_name = {{ campaign.name }} pour segmenter par contexte de recommandation dans Braze.
Identifier les utilisateurs avec des alias d’utilisateur Braze
Dans l’éditeur de payload, ajoutez user_alias.alias_name (par exemple, {{ person.username }}) et user_alias.alias_label (par exemple, username). Pour en savoir plus, consultez Objet alias d’utilisateur.
Lorsque les deux champs sont présents, le système identifie l’utilisateur par l’alias en plus de l’e-mail, et Braze crée un nouveau profil avec alias si aucune correspondance n’existe.

Les deux champs d’alias sont obligatoires. Si seul alias_name ou alias_label est défini, Talkable n’envoie pas d’alias d’utilisateur et le profil est identifié uniquement par e-mail.
Trouver et créer des utilisateurs dans Braze
- Par défaut, Braze fait correspondre le profil par adresse e-mail. Si aucun profil correspondant n’existe, Braze en crée un nouveau.
- Lorsqu’un alias d’utilisateur est configuré, Braze effectue également la correspondance sur cet alias et crée un nouveau profil avec alias si aucune correspondance n’est trouvée.
- Les ID externes ne sont pas utilisés par cette intégration. Pour associer les abonnements Talkable à un profil existant identifié de manière externe, configurez un alias d’utilisateur dont le libellé d’alias correspond à l’alias connu de ce profil.
Utiliser Talkable avec Braze
Trouver un utilisateur synchronisé
Accédez à Audience > Recherche d’utilisateurs et effectuez une recherche par e-mail pour afficher un profil créé ou mis à jour par Talkable.
Les champs standard (e-mail, téléphone, prénom ou nom) ainsi que les attributs personnalisés que vous avez configurés apparaissent sur le profil ; Email Subscribe affiche Opted In.
Créer un Segment de recommandation
- Créez un Segment filtré sur Email Subscribe est Opted In.
- Affinez avec les attributs personnalisés envoyés par Talkable — par exemple,
talkable_is_advocateégal àtruepour cibler les ambassadeurs, outalkable_campaign_nameégal au nom de votre Campaign pour cibler un programme de recommandation spécifique.
Déclencher des messages de cycle de vie
- Créez un Canvas ou une Campaign avec une livraison par événement. Les types de déclencheurs Braze suivants fonctionnent avec cette intégration :
- Update Subscription Status (par exemple, l’abonnement e-mail passe à Opted In)
- Update Subscription Group Status (lorsqu’un groupe d’abonnement est configuré)
- Change Custom Attribute Value (pour tout attribut personnalisé Talkable que vous envoyez).
- Personnalisez les messages avec les attributs personnalisés Talkable présents sur le profil (nom de la Campaign, valeur de la récompense, parrain, etc.).
Considérations
- Abonnement e-mail uniquement : les numéros de téléphone sont capturés en tant qu’attribut utilisateur standard, mais l’intégration ne définit pas de statut d’abonnement SMS. Talkable ne synchronise pas les abonnements SMS.
- Format de téléphone : Braze attend les numéros de téléphone au format international (E.164).
- Synchronisation en temps réel, déclenchée par événement : Talkable envoie une requête par événement d’abonnement (un utilisateur par requête). Il n’y a pas de traitement par lots ni de synchronisation complète périodique ; le volume suit celui de vos abonnements par recommandation.
- Distribution fiable : si Braze renvoie temporairement une erreur, Talkable effectue automatiquement de nouvelles tentatives. Les échecs persistants déclenchent l’envoi d’une alerte par e-mail à l’administrateur du site.
Résolution des problèmes
| Erreur | Cause probable | Correction |
|---|---|---|
| 401 Unauthorized | La clé API REST ne dispose pas des permissions users.track, ou l’endpoint pointe vers le mauvais cluster. |
Réémettez la clé avec les permissions users.track et confirmez que l’endpoint REST correspond à votre cluster Braze. |
| Endpoint REST rejeté lors de l’installation | L’URL n’est pas un endpoint REST Braze. | Utilisez l’endpoint REST de votre cluster, par exemple https://rest.iad-01.braze.com. Une URL de tableau de bord ne fonctionne pas. |
| Profil créé mais absent d’un groupe d’abonnement | Aucun ID de groupe d’abonnement configuré. | Saisissez l’ID du groupe d’abonnement dans l’action Email opt-in. |
| Alias d’utilisateur non appliqué | Un seul des deux champs d’alias (nom ou libellé) est renseigné. | Renseignez les deux champs dans l’action : nom d’alias et libellé d’alias. |
| Le profil n’apparaît pas | L’exemple de requête n’a pas encore été envoyé, ou l’action est désactivée. | Sélectionnez Send sample payload dans Talkable et assurez-vous que l’action Email opt-in est activée. |
| Les requêtes ne s’envoient plus après une rotation de clé | La clé API stockée a été révoquée ou remplacée dans Braze. | Dans l’App Store de Talkable, ouvrez l’application Braze, collez la nouvelle clé API REST, puis sélectionnez Save ; testez à nouveau avec Send sample payload. |
Pour plus d’informations sur l’intégration Talkable, consultez la documentation d’intégration Braze de Talkable. Pour contacter le support Talkable, envoyez un e-mail à [email protected].