> ## 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.

# Intégrer un CRM personnalisé ou interne à CloudTalk

> Connectez un CRM personnalisé ou interne à CloudTalk via l'API REST, les Webhooks, l'Automatisation des flux de travail ou une passerelle no-code comme Zapier…

<Note>
  CloudTalk ne propose pas de connecteur natif pour chaque CRM. Si vous avez développé votre propre système, ou si vous utilisez une plateforme qui ne figure pas dans notre liste d'intégrations natives, vous pouvez quand même le connecter à CloudTalk. Cet article présente les méthodes prises en charge.
</Note>

**Niveau d'utilisateur** : Admin

***

<h2 id="h_11b71a1c7b">
  Avant de commencer
</h2>

L'accès à l'API est disponible à partir du **plan Essential**. Pour savoir où trouver vos clés et comment les générer, consultez [Comment accéder à vos clés API CloudTalk et les générer.](/fr/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) Si l'onglet **Clés API** n'apparaît pas dans votre Dashboard, votre compte est probablement sur un plan inférieur. En cas de doute, contactez l'équipe support CloudTalk et nous vérifierons pour vous.

<h2 id="h_635fbfead1">
  Option 1 : intégration directe via l'API REST (pour les développeurs)
</h2>

CloudTalk met à disposition une API REST publique qui vous permet de lire et d'écrire des données par programmation, notamment les contacts, les appels et les enregistrements.

1. Générez vos identifiants API : allez dans **Compte > Paramètres > Clés API** et cliquez sur **+ Ajouter une clé API**. Copiez l'Access Key ID et l'Access Key Secret.

2. Envoyez vos requêtes à l'API sur **api.cloudtalk.io**, en utilisant l'authentification Basic (votre Key ID comme nom d'utilisateur et votre Secret comme mot de passe). Notez qu'il s'agit d'une adresse différente de [developers.cloudtalk.io](/developers) (la documentation) et de [dashboard.cloudtalk.io](https://dashboard.cloudtalk.io/) (le Dashboard) : assurez-vous donc que vos requêtes sont bien envoyées à api.cloudtalk.io.

3. Parcourez les endpoints disponibles et les formats de requête sur **[developers.cloudtalk.io](/developers)**.

4. Développez dans votre CRM la logique qui appelle ces endpoints lors des événements qui vous intéressent, par exemple la création ou la mise à jour d'un contact après la fin d'un appel.

<Warning>
  **Conseil :** testez vos appels dans un outil comme Postman avant de les intégrer à votre CRM. Utilisez l'option Authorization > Basic Auth et collez-y votre Key ID et votre Secret. Surveillez les en-têtes de réponse relatifs aux limites de débit et ralentissez vos requêtes si vous les atteignez ; les limites actuelles sont documentées sur [developers.cloudtalk.io](/developers).
</Warning>

<h2 id="h_58791abb69">
  Option 2 : recevoir les événements en temps réel avec les Webhooks (pour les développeurs)
</h2>

Les Webhooks envoient les événements CloudTalk vers un endpoint HTTPS qui vous appartient dès qu'ils se produisent, afin que votre CRM reste synchronisé sans interroger l'API en continu. Les événements couvrent les appels, les contacts, les utilisateurs, les messages, Conversation Intelligence, les VoiceAgents et le Numéroteur. Chaque événement est transmis en JSON signé.

1. Allez dans **Compte > Webhooks** et cliquez sur **Ajouter un endpoint**. Vous devez disposer du rôle Admin.

2. Saisissez votre URL HTTPS et choisissez les types d'événements souhaités. Laissez la sélection vide pour recevoir tous les événements, y compris ceux ajoutés ultérieurement.

3. Copiez le secret de signature de l'endpoint et vérifiez la signature à chaque livraison.

4. Cliquez sur **Send test event** et vérifiez que votre endpoint répond avec un code 2xx. Le résultat s'affiche dans le journal de livraison.

Les livraisons échouées font automatiquement l'objet de nouvelles tentatives, et vous pouvez les renvoyer ou les récupérer depuis la même page pendant 30 jours. Pour les payloads, la vérification des signatures et les bonnes pratiques, consultez le [guide développeur Webhooks](/guides/webhooks/overview).

<h2 id="h_0e615ae39c">
  Option 3 : envoyer les événements vers votre CRM avec l'Automatisation des flux de travail
</h2>

Si vous souhaitez que CloudTalk envoie automatiquement des données à votre CRM lorsqu'un événement se produit (par exemple à la fin d'un appel), vous pouvez créer une Automatisation des flux de travail qui envoie une requête HTTP vers un endpoint que vous contrôlez.

1. Dans votre CRM, ou sur un serveur que vous contrôlez, mettez en place un endpoint capable de recevoir des requêtes HTTP POST.

2. Dans CloudTalk, allez dans **Compte > Automatisations des flux de travail** et créez une automatisation qui se déclenche sur l'événement souhaité, puis ajoutez une action qui envoie une requête HTTP vers l'URL de votre endpoint. Consultez le [guide des Automatisations des flux de travail](/fr/articles/5450779-configuring-workflow-automations) pour la configuration.

3. CloudTalk envoie les données de l'événement à votre endpoint lorsque le déclencheur se produit.

4. Analysez le payload dans votre CRM pour mettre à jour des enregistrements, journaliser des appels ou déclencher des actions de suivi.

<Tip>
  **Bon à savoir :** les requêtes HTTP de l'Automatisation des flux de travail sont envoyées au mieux (best-effort). Si votre endpoint est temporairement injoignable, une livraison peut être perdue, et aucun renvoi en libre-service n'est possible. Si vous avez besoin d'une livraison fiable des événements avec nouvelles tentatives et renvoi, utilisez plutôt les Webhooks (Option 2).
</Tip>

<h2 id="h_089c28fdc5">
  Option 4 : passerelle no-code via Zapier ou Make
</h2>

Si vous préférez ne pas écrire de code, Zapier et Make peuvent servir de passerelle entre CloudTalk et votre CRM. Les deux prennent en charge CloudTalk à la fois comme déclencheur et comme source d'actions.

**Zapier :** suivez le guide [Configurer Zapier](/fr/articles/3410740-configure-zapier) pour connecter votre compte CloudTalk, puis créez un Zap qui se déclenche sur un événement CloudTalk et envoie les données vers votre CRM, soit via une action CRM native, soit via une étape webhook.

**Make (anciennement Integromat) :** ajoutez l'application CloudTalk dans Make (voir la documentation CloudTalk de Make sur [apps.make.com/cloudtalk](https://www.make.com/en/integrations/cloudtalk)), puis créez un scénario qui se déclenche sur un événement CloudTalk, par exemple un nouvel appel, et qui mappe les champs dans votre CRM. L'application CloudTalk de Make inclut une action générique « Make an API Call » : ainsi, même si votre CRM n'est pas une application native de Make, ou si vous avez besoin d'une opération CloudTalk sans module dédié, vous pouvez quand même atteindre n'importe quel endpoint CloudTalk via cette étape.

Les deux outils prennent en charge des étapes webhook/HTTP personnalisées : même un CRM qui n'est une application native sur aucune des deux plateformes peut donc recevoir des données.

<h2 id="h_9b237ff688">
  Quelle option choisir ?
</h2>

| | **API REST** | **Webhooks** | **Automatisation des flux de travail** | **Zapier / Make** |
| - | - | - | - | - |
| Nécessite du développement | Oui | Oui (endpoint et vérification de la signature) | Peu (mise en place d'un endpoint) | Non |
| Sens des données | Vous récupérez les données à la demande | CloudTalk les envoie lors d'un événement | CloudTalk les envoie lors d'un événement | Les deux |
| Idéal pour | Lectures en masse, synchronisation des contacts, contrôle total | Flux d'événements en temps réel vers votre CRM ou vos outils internes | Envoyer les événements d'appel vers votre système | Mise en place rapide, équipes no-code |
| Garantie de livraison | Vous gérez les nouvelles tentatives | Nouvelles tentatives automatiques, renvoi et récupération pendant 30 jours | Au mieux (best-effort), pas de renvoi en libre-service | Dépend de la plateforme |

***

*Besoin d'aide ou une question ?* Écrivez-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

- [Guide de démarrage avec CloudTalk](/fr/articles/10558672-getting-started-with-cloudtalk-guide.md)
- [Intégrer CloudTalk Phone dans une application web](/fr/articles/11791061-embedding-cloudtalk-phone-in-a-web-application.md)
- [Attributs personnalisés](/fr/articles/2144934-custom-attributes.md)


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