1-to-1 Engagement dans Salesforce
Table des matières
🎯 Objectif
L’objectif de cette intégration est de permettre à un conseiller d’envoyer un message sortant (1-to-1 Engagement) directement depuis l’environnement Salesforce, via le widget Alcméon.
Lorsqu’un conseiller souhaite contacter un client de manière proactive (en dehors d’une conversation existante), le widget passe automatiquement en mode Engagement.
Pour que cela fonctionne, Salesforce doit transmettre à Alcméon certaines informations via un objet dédié.
Â
🧩 Objet Salesforce requis : Alcmeon Engagement
L’intégration nécessite la création d’un objet personnalisé Salesforce nommé alcmeon__Engagement__c.
Cet objet est décrit dans la documentation développeur Alcméon :
👉 https://developers.alcmeon.com/docs/alcmeon-engagement
Cet objet sert de pont de données entre Salesforce et le widget Alcméon.
Il permet notamment :
d’identifier le contact dans Salesforce,
d’informer le widget qu’il doit passer en mode Engagement,
et de fournir les informations nécessaires à l’envoi du message via le bon canal (WhatsApp, Kakaotalk, Line…).
Â
🔧 Données à transmettre à Alcmeon
Lorsque le conseiller ouvre le widget Alcméon dans Salesforce, l’intégration doit envoyer les données suivantes :
| Champ | Description | Exemple |
|---|---|---|
| mode | Indique au widget de passer en mode “Engagement” | "engagement" |
| client_id | Identifiant unique du contact sur le canal | WhatsApp : numéro de téléphone → +33612345678Kakaotalk : app_user_id ou user_key
|
| canal | (optionnel) Canal Ă utiliser si plusieurs sont disponibles |
"whatsapp" ou "kakaotalk"
|
| autres métadonnées | (facultatif) Données utiles pour le contexte (nom, email, ID Salesforce, etc.) | { "sf_id": "0035g00001ABC123", "nom": "Dupont" } |
La liste complète des données à transmettre à Alcmeon dans l'objet Engagement est présente ici : 👉 Documentation développeur — Alcméon Engagement
Â
🪄 Comportement attendu côté widget
Une fois ces informations reçues :
Le widget se charge en mode “Engagement” au lieu du mode “Chat”.
Le conseiller voit l’interface d’envoi de message sortant (1-to-1).
Il peut alors :
- Sélectionner le modèle de message (template),
- Compléter les variables si nécessaire,
- Et envoyer le message au contact via le canal spécifié.
L’expérience utilisateur est identique à celle de l’envoi d’un message sortant depuis Alcméon Care.
Â
🔗 Référence technique
La structure complète de l’objet Alcmeon Conversation et les exemples d’intégration sont disponibles ici :
👉 Documentation développeur — Alcméon Engagement