Een VoiceAgent-oproep activeren vanuit HubSpot

​

Voordat u begint

• Een reeds aangemaakte CloudTalk VoiceAgent
• CloudTalk API-gegevens (API-sleutel en Secret)
• Een HubSpot-account met toegang tot Workflows
• Contacteigenschappen met ten minste een telefoonnummer

​

Een HubSpot-workflowtrigger maken

1. Open HubSpot > Workflows.
2. Maak een nieuwe Contact-based workflow.
3. Kies een triggertype, bijvoorbeeld:
   • Property value changed
   • List membership changed
     (Aangepaste velden worden ook ondersteund.)
     
4. Optioneel: Schakel Re-enrollment in als u wilt dat hetzelfde contact meerdere keren wordt gebeld telkens wanneer aan de voorwaarden wordt voldaan.
   

​

De actie Custom code toevoegen

1. Klik op + Actie toevoegen
2. Selecteer Data ops > Custom code
3. Configureer de actie:
   • Language: Node.js 20.x
   • Secrets: Laat leeg
   • Properties to include in code:
     • phone (verplicht)
     • Aanvullende velden naar behoefte, zoals name of contactId

​

Het codefragment plakken

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

• Stuurt een POST-verzoek naar de CloudTalk VoiceAgent API
• Geeft het telefoonnummer van het contact door
• Geeft optioneel variabelen door, zoals de voornaam of Record ID
• Ontvangt de VoiceAgent-output terug op het door u gekozen endpoint in CloudTalk

​

De autorisatieheader genereren

1. Ga naar https://www.debugbear.com/basic-auth-header-generator
2. Voer uw CloudTalk API-sleutel en CloudTalk API Secret in
   (te vinden in uw CloudTalk Bedrijfsinstellingen).
3. Kopieer de gegenereerde header. Deze ziet er ongeveer zo uit: Basic XXXXXXXXX

​

De workflow publiceren en testen

1. Sla de custom code-stap op.
2. Klik op Review and publish.
3. Bepaal of de workflow:
   • alleen moet worden uitgevoerd voor nieuwe contacten die aan de voorwaarden voldoen, of
   • ook moet worden uitgevoerd voor contacten die al voldoen wanneer de workflow wordt geactiveerd.
4. Activeer de workflow door een eigenschap of lijstlidmaatschap van een testcontact bij te werken.

​

De Enrollment history controleren

1. Open de workflow
2. Ga naar Performance history > Enrollment history
3. Zoek uw testcontact in de lijst