> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions

> Découvrez comment utiliser une Action dans vos Automatisations des flux de travail

<Note>
  Les *Automatisations des flux de travail* sont conçues pour faciliter le travail des agents en automatisant des processus comme l'envoi d'un SMS de suivi, la transcription de certains appels ou le transfert automatique des transcriptions vers Slack. Le type d'étape qui garantit l'exécution de ces actions s'appelle une **Action** (à ne pas confondre avec une *Action d'objet* sélectionnée dans le Déclencheur).
</Note>

**Niveau d'utilisateur :** Admin

***

<h2 id="h_2b27478f29">
  Configurer une Action
</h2>

Dans l'Automatisation des flux de travail, une étape **Action** est l'endroit où une tâche précise est exécutée automatiquement. Dès que les conditions qui précèdent cette étape sont remplies, l'action est déclenchée. C'est là que le système exécute des actions selon votre configuration.

Une étape **Action** d'automatisation des flux de travail peut être ajoutée au workflow à n'importe quel endroit après le **Déclencheur**. Il vous suffit de sélectionner l'option **`+ Ajouter une action`** lorsque vous configurez une nouvelle étape dans le workflow.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/0b872f47cd70-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=b68d6d7c7933e8ecd1c8a901fe53270b" alt="" width="1588" height="294" data-path="images/help-center/articles/5649782/0b872f47cd70-image.png" />
</Frame>

CloudTalk propose actuellement quatre types d'actions :

* **[Requête API](#h_0267cfe306)**

* **[SMS](#h_1714226b93)**

* **[Envoyer une notification à Slack](#h_1710cb965a)**

* **Speech to Text (visible uniquement lorsque le déclencheur *Enregistrement* est utilisé)**

<Note>
  Chaque workflow d'automatisation a besoin d'au moins une action pour fonctionner comme prévu. Vous pouvez ajouter plusieurs actions dans un même workflow pour rendre votre automatisation encore plus efficace.
</Note>

<h2 id="h_0267cfe306">
  Requête API
</h2>

<Warning>
  Vous avez simplement besoin de notifier votre propre système lorsqu'un événement se produit dans CloudTalk, comme la fin d'un appel ou la modification d'un contact ? Utilisez plutôt les [Webhooks](/guides/webhooks/overview). Les Webhooks sont conçus pour une transmission fiable des événements, avec des payloads signés, des nouvelles tentatives automatiques, ainsi qu'un renvoi et une récupération pendant 30 jours. Les actions Requête API empruntent un autre chemin de transmission, qui n'inclut pas ces fonctions.
</Warning>

Ce type d'Action convient aux utilisateurs à l'aise avec la technique, qui recherchent plus de liberté créative dans la conception de leurs automatisations. Une API (Application Programming Interface) permet à différentes applications web de communiquer. Pour l'instant, les requêtes peuvent être envoyées à l'[API REST de CloudTalk](/developers) ou à d'autres systèmes externes qui utilisent :

* des schémas d'authentification nécessitant des en-têtes statiques et immuables (par exemple les schémas d'authentification Basic ou Bearer)

* des systèmes avec authentification via l'URL ou le corps JSON.

L'API de CloudTalk est un exemple de ce second type. Chaque Action API comprend les composants suivants :

<table>
  <tbody>
    <tr>
      <td>
        « Nom »
      </td>

      <td>
        Définition
      </td>

      <td>
        Exemple de valeur
      </td>
    </tr>

    <tr>
      <td>
        **Point de terminaison**
      </td>

      <td>
        *URL du point de terminaison API correspondant*
      </td>

      <td>
        [`https://my.crmwebsite.com/api/contacts/index`](https://my.crmwebsite.com/api/contacts/index)
      </td>
    </tr>

    <tr>
      <td>
        **Méthode**
      </td>

      <td>
        *Définit l'action de la requête API*
      </td>

      <td>
        Acceptées : `PUT`, `POST`, `PATCH`, `GET`, `DELETE`
      </td>
    </tr>

    <tr>
      <td>
        **En-têtes**
      </td>

      <td>
        *Métadonnées, souvent nécessaires à l'authentification et à d'autres usages*
      </td>

      <td>
        Clé : `Autorisation`\
        Valeur : `Basic x1x2x3x4x5x6x789`
      </td>
    </tr>

    <tr>
      <td>
        **Valeurs**
      </td>

      <td>
        *Définissent le corps de la requête sous forme d'objet JSON*
      </td>

      <td>
        Clé : `contactName`

        Valeur : `Johnny Snow`

        Format : `String`
      </td>
    </tr>
  </tbody>
</table>

Utilisez la section **Valeurs** du générateur de requête API pour définir le corps d'une requête. Chaque entrée de la section **Valeurs** contient une *Clé*, une *Valeur,* et un *Format*.

Dans ce cas, **Clé** correspond au *nom de la propriété* dans la requête API. Par exemple :

```
contactName
```

La **Valeur** peut être *statique*. Elle peut ressembler à ceci :

```
Johnny Snow
```

Cette valeur peut aussi être une propriété *dynamique* qui envoie la valeur saisie à partir des données issues du Déclencheur que vous avez choisi. Pour obtenir une valeur dynamique, choisissez l'une des expressions en bleu dans la barre latérale **Données utiles pour votre Workflow**. Comme illustré ci-dessous, le champ **Valeur** devrait se remplir avec quelque chose comme :

```
#{{event.properties.contacts[0].name}}
```

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/d2fb43651165-api-ref.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=45f397722e6dc9f680d6d5fd50eaf711" alt="" width="1996" height="792" data-path="images/help-center/articles/5649782/d2fb43651165-api-ref.png" />
</Frame>

Cet exemple récupérerait la valeur *name* du contact associé à votre Déclencheur.

La valeur **Format** décrit un type de données, afin que le système cible (l'API) puisse interpréter correctement les données transmises. CloudTalk prend en charge les formats suivants :

* **Numéro** - nombres entiers ou décimaux (nombres à virgule flottante avec un point comme séparateur décimal)

* **String** - suite de caractères alphanumériques

* **Boolean** - prend la valeur True ou False (toute forme non définie vaut False par défaut)

* **Auto** - le type est détecté automatiquement

<h2 id="h_1714226b93">
  SMS
</h2>

L'étape Action SMS garantit l'envoi d'un SMS au numéro indiqué dans le cadre de l'automatisation. En arrière-plan, le système envoie une requête API contenant les informations configurées au [point de terminaison API Send SMS de CloudTalk](/developers#tag/Sms/paths/~1sms~1send.json/post), ce qui déclenche l'envoi du SMS sans intervention de l'agent.

Pour configurer l'Action SMS, vous devez définir les attributs suivants :

* ***Destinataire*** - numéro de téléphone, au format international, auquel le SMS doit être envoyé

* ***Expéditeur*** - numéro de téléphone compatible SMS, au format international, depuis lequel le SMS doit être envoyé

* ***Texte*** - contenu du message à envoyer

* ***Clé API*** et ***API Secret*** - identifiants d'API récupérés dans le CloudTalk Dashboard par un Admin

Comme cette action implique une requête vers l'API de CloudTalk, les limites de débit standard s'appliquent. Pour plus de détails, consultez notre [documentation API](/developers#section/API-Overview/Usage).

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/8f6e29a0f474-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=22082be676499acccf008dbd4e51109e" alt="" width="1632" height="1022" data-path="images/help-center/articles/5649782/8f6e29a0f474-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/54745a3951f9-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=e22b01ccc3974d5eb393c08aeb731faa" alt="" width="1632" height="1128" data-path="images/help-center/articles/5649782/54745a3951f9-image.png" />
</Frame>

<h4 id="h_ed9b4080e8">
  Problèmes courants
</h4>

* Les numéros dans les champs **Destinataire** et **Expéditeur** doivent être au **format international**.

* Le numéro utilisé comme **Expéditeur** doit être **compatible SMS**.

* Les identifiants d'API doivent être saisis **sans espaces supplémentaires**.

* Assurez-vous que votre **crédit de compte** est suffisant, car l'automatisation des SMS entraîne des coûts supplémentaires.

<h2 id="h_1710cb965a">
  Envoyer une notification à Slack
</h2>

Ce type d'Action est souvent utilisé pour les notifications internes : il permet de transmettre des informations importantes vers un canal Slack de l'entreprise. Pour utiliser cette option, assurez-vous d'être connecté à l'espace de travail et au canal Slack appropriés. Vérifiez également que les portées du token pour l'espace de travail et le canal incluent les autorisations **chat:write**.

Pour configurer l'action Envoyer une notification à Slack, les attributs suivants doivent être définis :

* **Token** : un token d'authentification généré depuis l'interface de Slack.

* **Channel** : le canal Slack dans lequel les messages seront publiés.

* **Texte** : le contenu du message.

* **Icon\_emoji** : une icône emoji pour représenter le message.

* **Icon\_url** : l'URL d'une icône personnalisée pour représenter le message.

* **Use\_markdown** : lorsqu'il est réglé sur **True**, le **texte** s'affiche comme du texte formaté.

Comme pour les requêtes API, la valeur de chaque paramètre peut être définie de façon statique ou dynamique. Pour utiliser une valeur dynamique, cliquez dans le champ **Valeur**, puis sélectionnez l'une des expressions en bleu dans la barre latérale **Données utiles pour votre Workflow**.

La notification Slack obtenue peut ressembler à ceci :

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/f3b072d2646e-slack-result.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=0cb4ffc97c5d425a638e6915361164ab" alt="" width="697" height="454" data-path="images/help-center/articles/5649782/f3b072d2646e-slack-result.png" />
</Frame>

<h2 id="h_8f5fef5c11">
  Transcription Speech to Text
</h2>

Ce type d'Action sert généralement à transcrire par écrit les conversations enregistrées pendant un appel. Gardez en tête que cette Action n'est disponible que lorsque le Déclencheur **Enregistrement téléchargé** est sélectionné.

Pour configurer l'action Speech to Text, les attributs suivants doivent être définis :

* **Langue**

* **Transcription améliorée**

* **Modèle**

[En savoir plus](/fr/articles/5671571-speech-to-text-transcription) sur la transcription Speech-to-Text pour mieux comprendre le fonctionnement de cette fonctionnalité, ses options et les coûts associés.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/f5c7880d5efa-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=854c2d7540c6b4020503a28f755307c0" alt="" width="1458" height="1310" data-path="images/help-center/articles/5649782/f5c7880d5efa-image.png" />
</Frame>

<h2 id="h_b4bcdfa5d9">
  Réutiliser le résultat de nœuds Action précédents
</h2>

Vous pouvez référencer dynamiquement la réponse d'une étape Action Requête API précédente dans les étapes suivantes de votre workflow.

<h3 id="h_8f05ed7c5f">
  Comment cela fonctionne
</h3>

Pour accéder aux données renvoyées par une Action Requête API antérieure, vous devez utiliser le **format exact** :

```
#{{ actionData.[actionIdentifier].message.[fieldName] }}
```

* `[actionIdentifier]` est l'identifiant unique du nœud Action, attribué lors de son ajout (par exemple un identifiant généré par le système comme `28547585`, ou un nom personnalisé comme `SendToCRM`)

* `message` représente le corps de la réponse, qui doit être un objet JSON

* `[fieldName]` est n'importe quel champ de cet objet JSON

<Warning>
  Le préfixe `.message.` est **obligatoire** lorsque vous référencez les données de la réponse. Si vous l'omettez ou utilisez une autre structure, la référence sera cassée.
</Warning>

*Exemple*

Imaginons un nœud Action Requête API identifié comme `CreateLead`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/0B2VFDHod1TeIVNA/images/help-center/articles/5649782/9ea2ff3e154d-image.png?fit=max&auto=format&n=0B2VFDHod1TeIVNA&q=85&s=ed7fd12fe9cea1916099cea8ffe5ac95" alt="" width="1644" height="298" data-path="images/help-center/articles/5649782/9ea2ff3e154d-image.png" />
</Frame>

L'action Requête API `CreateLead` renvoie cette réponse :

```json theme={"system"}
{
  "lead_id": "abc123",
  "status": "created"
}
```

Pour référencer le `lead_id` dans une autre Action, utilisez la référence :

```
#{{ actionData.CreateLead.message.lead_id }}
```

***

*Besoin d'aide ou une question ?* Contactez-nous via notre [Portail Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — nous sommes là pour vous.


## Related topics

- [Actions Salesforce](/fr/articles/9394264-salesforce-actions.md)
- [Configurer les Automatisations des flux de travail](/fr/articles/5450779-configuring-workflow-automations.md)
- [Configurer Zapier](/fr/articles/3410740-configure-zapier.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.