> ## 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.
# Déclencher un appel VoiceAgent depuis HubSpot
> Automatisez les appels VoiceAgent depuis HubSpot
Vous pouvez déclencher automatiquement un appel VoiceAgent CloudTalk à l'aide des Workflows HubSpot. Ce guide vous montre comment configurer le déclencheur, transmettre les données du contact à CloudTalk et consulter les résultats d'inscription dans HubSpot.
**Niveau d'utilisateur** : Agent
***
Avant de commencer
Vous aurez besoin de :
* Un VoiceAgent CloudTalk déjà créé
* Des identifiants d'API CloudTalk (Clé API et Secret)
* Un compte HubSpot avec accès aux Workflows
* Des propriétés de contact incluant au moins un numéro de téléphone
Créer un déclencheur de workflow HubSpot
1. Ouvrez **HubSpot > Workflows**.
2. Créez un nouveau workflow **Contact-based**.
3. Choisissez un type de déclencheur, par exemple :
* Property value changed
* List membership changed\
(Les champs personnalisés sont également pris en charge.)
4. **Facultatif** : activez **Re-enrollment** si vous souhaitez que le même contact soit appelé plusieurs fois dès que les conditions sont remplies.
Ajouter l'action Custom code
Une fois votre déclencheur configuré :
1. Cliquez sur **`+ Ajouter une action`**
2. Sélectionnez **Data ops > Custom code**
3. Configurez l'action :
* **Language:** Node.js 20.x
* **Secrets:** laissez vide
* **Properties to include in code:**
* `phone` (obligatoire)
* D'autres champs selon vos besoins, comme `name` ou `contactId`
Ces propriétés deviennent `event.inputFields[...]` dans le script.
Coller l'extrait de code
```
const axios = require('axios');
exports.main = async (event, callback) => {
const phone = event.inputFields['phone'];
const name = event.inputFields['name'];
const contactId = event.inputFields['contactId'];
try {
// Convert hs_object_id to integer
const contactIDint = parseInt(contactId, 10);
// Check if conversion was successful
if (isNaN(contactIDint)) {
throw new Error('Invalid hs_object_id: not a number');
}
// Prepare request body
const data = {
call_number: phone,
voice_agent_id: "67eba86558ba995b89e05e08",
call_properties: {
system_prompt: {
variables: {
name: name
}
},
output: {
variables: {
contactID: contactIDint
}
}
}
};
// Send POST request
const response = await axios.post('https://api.cloudtalk.io/v1/voice-agent/calls', data, {
headers: {
'Authorization': 'Basic #{{ Auth Header}}',
'Content-Type': 'application/json'
}
});
// Log success and return
console.log('Call triggered successfully:', response.data);
callback({
outputFields: {
status: 'Call triggered successfully'
}
});
} catch (error) {
console.error('Error triggering call:', error.message);
callback({
outputFields: {
status: `Error: ${error.message}`
}
});
}
};
```
**Ce script** :
* Envoie une requête POST à l'API VoiceAgent de CloudTalk
* Transmet le numéro de téléphone du contact
* Transmet éventuellement des variables comme le prénom ou le Record ID
* Récupère la sortie du VoiceAgent vers l'endpoint que vous avez sélectionné dans CloudTalk
Générer l'en-tête d'autorisation
CloudTalk utilise l'authentification Basic pour les requêtes API.\
Pour générer votre valeur encodée :
1. Rendez-vous sur **[https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)**
2. Saisissez votre **Clé API CloudTalk** et votre **Secret d'API CloudTalk**\
(disponibles dans les **Paramètres de l'entreprise** de CloudTalk).
3. Copiez l'en-tête généré. Il ressemblera à : `Basic XXXXXXXXX`
Remplacez `#{{ Auth Header }}` dans le script par cette valeur.
Publier et tester le workflow
1. Enregistrez l'étape de code personnalisé.
2. Cliquez sur **Review and publish**.
3. Déterminez si le workflow doit :
* S'exécuter uniquement pour les nouveaux contacts qui remplissent les conditions, ou
* S'exécuter également pour les contacts qui remplissent déjà les conditions au moment de l'activation du workflow.
4. Déclenchez le workflow en modifiant une propriété ou l'appartenance à une liste pour un contact de test.
Vérifier l'historique des inscriptions
Pour vérifier que votre appel VoiceAgent a bien été déclenché :
1. Ouvrez le workflow
2. Accédez à **Performance history > Enrollment history**
3. Repérez votre contact de test dans la liste
Si tout a fonctionné, vous devriez voir le contact inscrit ainsi que l'action **Call triggered successfully**.
**Tout est prêt !**
Votre workflow HubSpot déclenchera désormais automatiquement un appel VoiceAgent CloudTalk dès qu'un contact remplit les conditions que vous avez choisies.
***
*Besoin d'aide ou une question ?* Contactez-nous simplement via notre [Portail Support](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — nous sommes là pour vous.
## Related topics
- [Déclencher un appel VoiceAgent depuis Freshdesk](/fr/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [Déclencher un appel VoiceAgent depuis Freshservice](/fr/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
- [Déclencher un appel VoiceAgent depuis Pipedrive](/fr/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.