Envoyer un message WhatsApp depuis Salesforce Flow
Salesforce n'envoie pas de webhooks sortants comme le font Zoho ou HubSpot. Les modifications d'enregistrements y sont reliées à des actions via Flow Builder, et pour joindre une API externe, on utilise une action HTTP Callout dans un Record-Triggered Flow. Le mécanisme est différent, mais le résultat est le même : un commercial ou un responsable reçoit un message WhatsApp dès qu'un élément change, plutôt qu'une alerte e-mail qui reste non lue.
Ce guide montre comment relier un Record-Triggered Flow sur Opportunity ou Case à l'API messages de TextMeFlow, sans package AppExchange.
Étape 1 : définir le service externe (ou un simple callout Apex)
L'action HTTP Callout de Flow nécessite soit un External Service enregistré (à partir d'un schéma OpenAPI), soit une petite classe Apex invocable. Pour un seul endpoint comme POST /v1/messages, une classe Apex demande moins de configuration que l'import d'une définition de service externe :
public class TextMeFlowSender {
@InvocableMethod(label='Send WhatsApp via TextMeFlow')
public static void send(List<Request> requests) {
for (Request req : requests) {
HttpRequest httpReq = new HttpRequest();
httpReq.setEndpoint('https://api.textmeflow.eu/v1/messages');
httpReq.setMethod('POST');
httpReq.setHeader('Authorization', 'Bearer ' + TextMeFlowSecret.getToken());
httpReq.setHeader('Content-Type', 'application/json');
httpReq.setBody(JSON.serialize(new Map<String, String>{
'to' => req.phone,
'text' => req.message
}));
new Http().send(httpReq);
}
}
public class Request {
@InvocableVariable(required=true) public String phone;
@InvocableVariable(required=true) public String message;
}
}
Stockez le jeton d'API dans un Custom Metadata Type ou un Named Credential plutôt que de l'écrire en dur. TextMeFlowSecret.getToken() ci-dessus représente le mécanisme de stockage des secrets que votre organisation utilise déjà. Ajoutez api.textmeflow.eu dans Setup → Security → Remote Site Settings, sinon le callout échoue avec une erreur UNAUTHORIZED_ENDPOINT avant même d'atteindre TextMeFlow.
Étape 2 : créer le Record-Triggered Flow
Dans Setup → Flows, créez un nouveau Record-Triggered Flow sur Opportunity, réglez-le sur « only when a record is updated to meet the condition » et définissez la condition d'entrée StageName = 'Closed Won' avec « Only when specified changes are made », pour qu'il ne se déclenche pas à chaque enregistrement.
Ajoutez un élément Action après le déclencheur, choisissez la méthode invocable (Send WhatsApp via TextMeFlow) et associez :
phone→ le champ mobile du propriétaire (ou le téléphone de l'enregistrement User lié à l'Opportunity Owner)message→ un modèle de texte construit avec{!$Record.Name}et{!$Record.Amount}
Exécutez le Flow en After Save et de façon asynchrone si le callout n'a pas besoin de bloquer la transaction d'enregistrement. C'est le cas pour la plupart des notifications, et l'exécution asynchrone évite d'ajouter de la latence à l'action de l'utilisateur.
Étape 3 : normaliser les numéros de téléphone avant le callout
Les champs téléphone de Salesforce sont du texte libre, comme dans la plupart des CRM : un commercial peut avoir saisi 0472 93 22 08, +32 472 93 22 08 ou 0032472932208. Normalisez avant l'envoi plutôt qu'après un appel d'API en échec :
public static String toE164(String raw, String defaultCountry) {
String digits = raw.replaceAll('[^0-9]', '');
if (raw.startsWith('+')) return '+' + digits;
if (digits.startsWith('00')) return '+' + digits.substring(2);
if (digits.startsWith('0')) return '+' + defaultCountry + digits.substring(1);
return '+' + digits;
}
Appelez cette méthode depuis la classe Apex avant de construire le corps de la requête, et ignorez complètement le callout (en le consignant dans un log) si le résultat ne ressemble pas à un numéro E.164 plausible. La même logique de normalisation fonctionne quel que soit le langage qui construit la requête. Si vous faites passer le callout par un endpoint intermédiaire plutôt que directement par Apex, des exemples PHP, Python et Node figurent dans la documentation.
Étape 4 : gérer les mises à jour en masse en toute sécurité
Les Record-Triggered Flows peuvent s'exécuter en masse : une mise à jour groupée depuis une vue de liste ou un import via data loader peut déclencher le Flow pour des centaines d'enregistrements à la fois. Comme la méthode Apex invocable ci-dessus accepte une List<Request>, Flow regroupe automatiquement les callouts lors des opérations en masse, mais Salesforce limite aussi les callouts synchrones à 100 par transaction. Pour tout ce qui pourrait raisonnablement toucher plus de 100 enregistrements à la fois (par exemple un changement d'étape d'Opportunity en masse via data loader), exécutez le Flow de façon asynchrone ou passez par un job Queueable Apex plutôt que par un callout synchrone direct, faute de quoi les enregistrements au-delà de la limite échoueront sans bruit.
Étape 5 : réserver ce montage aux notifications internes
Ce schéma sert à alerter votre propre équipe : un commercial lorsque son affaire est conclue, un responsable support lorsqu'un Case passe en priorité haute, un utilisateur de la finance lorsqu'une Opportunity liée à une facture atteint une étape de facturation. Ce n'est pas un moyen de contacter le client ou le contact de l'enregistrement sans opt-in préalable. Cela relève de la communication client et exige une gestion correcte du consentement via le pipeline anti-spam de TextMeFlow (limites de débit, score de risque, gestion de STOP, heures calmes), pas d'un callout de Flow interne.
À quoi cela sert
Bons usages : prévenir le propriétaire d'une Opportunity à l'instant où une affaire passe à Closed Won, alertes d'escalade pour les Cases à haute priorité, solliciter un approbateur lorsqu'un devis attend sa validation. Pour tout ce qui s'adresse aux clients, comme les confirmations de commande ou les rappels de rendez-vous envoyés au contact lui-même, créez un flow distinct avec un opt-in documenté, au lieu de réutiliser le Flow de notification interne ci-dessus.
Démarrez gratuitement avec TextMeFlow : 50 messages par mois, sans limite de durée, de quoi créer et tester un callout Salesforce Flow avant de choisir un forfait payant.
Envie d'envoyer des messages WhatsApp via API ?
Gratuit pour toujours jusqu'à 50 messages/mois. Scannez un QR et envoyez votre premier message en 5 minutes.
Gratuit pour toujours