Skip to main content
L’étape Requête HTTP peut appeler directement votre org Salesforce. Lorsque le point de terminaison correspond à l’adresse de votre org Salesforce, CloudTalk signe la requête avec votre intégration Salesforce connectée : vous n’avez donc jamais à saisir d’identifiants Salesforce dans le flux d’appels.
Niveau d’utilisateur : Admin

​
Avant de commencer

  • Votre intégration Salesforce doit être connectée et active dans CloudTalk (Dashboard > Intégrations). Consultez Configurer Salesforce.
  • Le point de terminaison doit utiliser le domaine propre à votre org, par exemple https://yourcompany.my.salesforce.com/.... Les autres adresses Salesforce, telles que login.salesforce.com ou Marketing Cloud, ne sont pas prises en charge.
  • Vous devez savoir quel appel de l’API REST Salesforce vous souhaitez effectuer. La documentation de l’API Salesforce répertorie les points de terminaison disponibles.

​
Configurer la requête

  1. Ajoutez une étape Requête HTTP à votre flux d’appels (voir le guide Étape Requête HTTP).
  2. Dans Point de terminaison, saisissez l’URL complète de l’API Salesforce sur le domaine de votre org.
  3. Choisissez la Méthode et renseignez les En-têtes de requête et le Corps de la requête selon les exigences de l’API Salesforce. Pour un corps au format JSON, ajoutez l’en-tête Content-Type: application/json.
  4. N’ajoutez pas d’en-tête Authorization. CloudTalk ajoute l’authentification pour vous à partir de l’intégration connectée.
  5. Enregistrez le flux.
Chaque fois qu’un appel atteint cette étape, CloudTalk envoie la requête à Salesforce au nom de votre intégration. Vous pouvez utiliser des variables dynamiques telles que #{{call.external_number}} dans le point de terminaison, les en-têtes et le corps, exactement comme dans n’importe quelle étape Requête HTTP.

​
Exemple : enregistrer un appel entrant comme tâche Salesforce

ChampValeur
Point de terminaisonhttps://yourcompany.my.salesforce.com/services/data/v58.0/sobjects/Task
MéthodePOST
En-têtesContent-Type = application/json
CorpsObjet = Inbound call from #{{call.external_number}}Statut = TerminéPriorité = Normale
Analyser la réponseDésactivé (envoi sans attente de réponse)

​
Utiliser la réponse Salesforce dans un séparateur de condition

Lorsque l’option Analyser la réponse est activée, la réponse de Salesforce est stockée comme un bloc unique. Dans un Séparateur de condition, vous pouvez :
  • Vérifier le code de statut : sélectionnez Réponse HTTP, chemin statusCode, par exemple égal à 200.
  • Vérifier si la réponse contient une valeur : sélectionnez Réponse HTTP, chemin body, opérande contient.
Remarque : la lecture d’un champ Salesforce précis dans la réponse (par exemple records.0.Id) n’est pas prise en charge pour le moment.

​
Si l’intégration n’est pas disponible

Si votre intégration Salesforce est désactivée, n’est pas connectée ou si le point de terminaison ne correspond pas à l’org à laquelle elle est connectée, la requête n’est pas envoyée à Salesforce. L’étape est consignée comme ayant échoué et le flux d’appels passe à l’étape suivante. Les appelants ne sont pas affectés.

​
Bon à savoir

  • La communication doit se faire en HTTPS.
  • Lorsque l’option Analyser la réponse est activée, le flux attend jusqu’à 10 secondes la réponse de Salesforce. Lorsqu’elle est désactivée, la requête est envoyée et le flux continue au bout de 3 secondes au maximum.
  • Les requêtes sont décomptées de vos limites d’API Salesforce, comme n’importe quel autre appel d’API.
Besoin d’aide ou une question ? Contactez-nous simplement via notre Portail Support. Nous sommes là pour vous.