Déclencher un appel VoiceAgent depuis HubSpot

​

Avant de commencer

• 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

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

​

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}`
      }
    });
  }
};

• 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

1. Rendez-vous sur 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

​

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

1. Ouvrez le workflow
2. Accédez à Performance history > Enrollment history
3. Repérez votre contact de test dans la liste