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

# Clay

> Créez des contacts et envoyez des SMS à partir de Clay en utilisant votre numéro Quo pour transformer des leads enrichis en vraies conversations en quelques secondes. Nous vous montrerons comment configurer l’intégration et les possibilités qu’elle offre.

<div id="overview">
  ## Aperçu
</div>

L'[intégration Clay](https://www.clay.com/integrations/data-provider/quo) vous permet de créer automatiquement des contacts dans Quo et d’envoyer des SMS personnalisés à partir de votre numéro Quo en utilisant l’[API Quo](https://support.quo.com/fr-CA/core-concepts/integrations/api).

<Note>
  Cette intégration nécessite un abonnement Quo actif, des crédits prépayés pour la messagerie via l’API et des autorisations **Owner ou Admin** dans votre espace de travail.
</Note>

<div id="how-the-integration-works">
  ## Fonctionnement de l’intégration
</div>

Les actions dans Quo sont déclenchées directement à partir des **lignes de votre table Clay**.

<div id="available-actions">
  ### Actions disponibles
</div>

<Columns cols={2}>
  <Column>
    <Card title="Créer un contact">
      Clay peut créer automatiquement des contacts dans Quo en utilisant les données d’une ligne de tableau, dont :

      * Nom
      * Numéro de téléphone
      * Courriel
      * Entreprise

      Une fois créé, le contact apparaît dans votre espace de travail Quo et les appels et messages futurs sont rattachés à ce contact.
    </Card>
  </Column>

  <Column>
    <Card title="Envoyer des SMS">
      Clay peut envoyer des SMS sortants à partir du numéro de téléphone Quo que vous avez sélectionné.

      * Les messages sont envoyés par l’API Quo
      * Les conversations apparaissent dans votre boîte de réception Quo
      * Les réponses sont renvoyées directement dans Quo
      * Des variables dynamiques provenant de Clay peuvent être utilisées pour la personnalisation
    </Card>
  </Column>
</Columns>

***

<div id="data-flow-and-limitations">
  ## Flux de données et limitations
</div>

<div id="action-based-integration">
  ### Intégration axée sur les actions
</div>

* **Actions unidirectionnelles :** Les données circulent de Clay vers Quo, donc les modifications effectuées dans Quo ne mettront pas automatiquement à jour votre tableau Clay.
* Une requête API est déclenchée pour chaque ligne
* Ce n’est pas une synchronisation en temps réel

<Note>
  Toute la logique d’automatisation et les règles de déclenchement pour l’envoi de SMS ou la création de contacts sont configurées dans Clay.
</Note>

***

<div id="messaging-requirements">
  ## Exigences relatives à la messagerie
</div>

<div id="us-business-texting-registration">
  ### Enregistrement pour la messagerie texte d’entreprise aux États-Unis
</div>

Pour envoyer des messages à des numéros de téléphone américains :

* L’enregistrement auprès des opérateurs américains doit être approuvé
* Les messages ne seront pas remis si l’enregistrement est incomplet

<Note>
  Pour en savoir plus, consultez la page [Carrier Registration (A2P 10DLC) with Quo.](https://support.quo.com/fr-CA/getting-started/carrier-registration/carrier-registration)
</Note>

<div id="api-messaging-credits">
  ### Crédits de messagerie via l’API
</div>

Les messages envoyés depuis Clay sont traités comme des messages API et utilisent des crédits API prépayés. Si vous **n’avez pas assez de crédits API disponibles, vos SMS ne seront pas envoyés**.

<Note>
  Consultez notre article [Crédits prépayés et facturation à l’utilisation](https://support.quo.com/fr-CA/core-concepts/administration/billing/credits-and-usage) pour savoir comment ajouter des crédits à votre espace de travail.
</Note>

***

<div id="who-can-access-and-set-up-the-integration">
  ## Qui peut accéder à l’intégration et la configurer ?
</div>

<div id="quo">
  ### Quo
</div>

Vous aurez besoin d’un abonnement actif à Quo et d’être **Propriétaire ou Admin** de l’espace de travail pour authentifier Quo dans Clay.

**Pour utiliser l’action SMS, vous aurez également besoin de :**

* [Crédits d’API de messagerie prépayés](https://support.quo.com/fr-CA/core-concepts/administration/billing/credits-and-usage#pre-paid-credits-and-usage-based-billing)
* Votre [inscription auprès des opérateurs américains](https://support.quo.com/fr-CA/getting-started/carrier-registration/carrier-registration) complétée (si vous envoyez des SMS à des numéros américains)

<div id="clay">
  ### Clay
</div>

Un compte Clay actif avec le forfait Explore ou un forfait supérieur est nécessaire pour configurer et déclencher des actions Quo.

***

<div id="how-to-set-up-the-clay-integration">
  ## Comment configurer l’intégration Clay
</div>

L’intégration Clay utilise la fonctionnalité d’enrichissement via l’API HTTP de Clay pour déclencher des actions dans Quo directement à partir des lignes de votre table Clay.

<div id="1-get-your-quo-api-key">
  ### 1. Obtenez votre clé API Quo
</div>

Vous aurez besoin d’une clé API Quo pour authentifier les requêtes de Clay.

1. Connectez-vous à Quo avec des droits de propriétaire ou d’administrateur
2. Accédez à **Settings → API**
3. Cliquez sur **Generate API key**
4. Donnez-lui un nom comme "Clay"
5. Copiez la clé (vous la collerez lors de la configuration)

<div id="2-create-a-clay-table">
  ### 2. Créer un tableau Clay
</div>

1. Ouvrez Clay
2. Créez ou ouvrez un tableau Clay existant
3. Ajoutez des colonnes contenant les données que vous voulez envoyer à Quo, comme : prénom nom de famille numéro de téléphone adresse courriel entreprise texte du message SMS

Chaque ligne représentera un prospect ou un contact.

<div id="3-add-the-http-api-enrichment">
  ### 3. Ajouter l’enrichissement via l’API HTTP
</div>

1. Cliquez sur **Add enrichment**
2. Recherchez et sélectionnez **HTTP API**
3. Vous verrez deux onglets : **Generate (AI-assisted)** et **Configure (manual)**. Vous pouvez utiliser l’une ou l’autre méthode, mais les exemples ci-dessous présentent la configuration manuelle. [En savoir plus ici](https://university.clay.com/docs/http-api-integration-overview#option-b-manual-configuration).
4. Configurez le champ de l’en-tête d’authentification et collez votre clé API Quo.

<Frame>
  <img src="https://mintcdn.com/resource-center/5UpkHzFKYo59PINU/images/Clay_HTTP_Enrichment.png?fit=max&auto=format&n=5UpkHzFKYo59PINU&q=85&s=f5c178dc719dacf7e8910b1cdcbf3c12" alt="Enrichissement HTTP Clay" width="1502" height="968" data-path="images/Clay_HTTP_Enrichment.png" />
</Frame>

***

<div id="how-to-use-actions-in-clay">
  ## Comment utiliser les actions dans Clay
</div>

<div id="create-contacts-in-quo">
  ### Créer des contacts dans Quo
</div>

Ensuite, configurez une colonne d'enrichissement via l'API HTTP pour créer des contacts.

| **Method** | **Endpoint**                                                                   |
| ---------- | ------------------------------------------------------------------------------ |
| POST       | [https://api.openphone.com/v1/contacts](https://api.openphone.com/v1/contacts) |

```text Request body example theme={null}
{
  "defaultFields": {
    "firstName": "/First Name",
    "lastName": "/Last Name",
    "company": "/Company",
    "phoneNumbers": [
      {
        "name": "primary",
        "value": "/Phone"
      }
    ],
    "emails": [
      {
        "name": "work",
        "value": "/Email"
      }
    ]
  }
}
```

Clay remplacera chaque référence de colonne par les valeurs de la ligne. Lors de l'exécution de l'enrichissement, un nouveau contact sera créé dans Quo.

<Frame>
  <img src="https://mintcdn.com/resource-center/FEtDArjINrO8Jcji/images/Clay_CreateContact.png?fit=max&auto=format&n=FEtDArjINrO8Jcji&q=85&s=365ba3380a244b5a4971ccbc7ff9989a" alt="Créer un contact dans Clay" width="3474" height="2064" data-path="images/Clay_CreateContact.png" />
</Frame>

<div id="send-sms-messages-from-clay">
  ### Envoyer des SMS depuis Clay
</div>

Vous pouvez également configurer un enrichissement via l'API HTTP pour envoyer des SMS. Ajoutez une deuxième colonne d'enrichissement via l'API HTTP.

| **Method** | **Endpoint**                                                                   |
| ---------- | ------------------------------------------------------------------------------ |
| POST       | [https://api.openphone.com/v1/messages](https://api.openphone.com/v1/messages) |

```text Request body example theme={null}
{
  "content": "/SMS Message",
  "from": "/Quo Number",
  "to": [
    "/Phone"
  ]
}
```

<Frame>
  <img src="https://mintcdn.com/resource-center/uxbi15jp8UMqus7N/images/Clay_SendSMS_Integration_2026.png?fit=max&auto=format&n=uxbi15jp8UMqus7N&q=85&s=38a3cddcbb781445d68a5b5bc5d9c718" alt="Clay Send SMS Integration 2026" width="2048" height="1085" data-path="images/Clay_SendSMS_Integration_2026.png" />
</Frame>

Une fois la configuration terminée, **cliquez sur Run** dans votre ligne (ou activez l'exécution automatique pour les nouvelles lignes).

<Note>
  Pour obtenir des instructions détaillées sur la configuration de l'API, consultez notre [article sur les intégrations API](https://support.quo.com/fr-CA/core-concepts/integrations/api).
</Note>

***

<div id="need-support">
  ## Besoin d’aide ?
</div>

Soumettez une demande d’assistance sur [**support.quo.com**](http://support.quo.com/) pour obtenir de l’aide avec la configuration de l’intégration Clay.