VoiceAgent-Anruf aus HubSpot auslösen

​

Bevor Sie beginnen

• Einen bereits erstellten CloudTalk VoiceAgent
• CloudTalk-API-Zugangsdaten (API-Schlüssel und Secret)
• Ein HubSpot-Konto mit Zugriff auf Workflows
• Kontakteigenschaften, die mindestens eine Telefonnummer enthalten

​

HubSpot-Workflow-Trigger erstellen

1. Öffnen Sie HubSpot > Workflows.
2. Erstellen Sie einen neuen Contact-based-Workflow.
3. Wählen Sie einen Triggertyp, zum Beispiel:
   • Property value changed
   • List membership changed
     (Benutzerdefinierte Felder werden ebenfalls unterstützt.)
     
4. Optional: Aktivieren Sie Re-enrollment, wenn derselbe Kontakt mehrfach angerufen werden soll, sobald die Bedingungen erfüllt sind.
   

​

Custom-Code-Aktion hinzufügen

1. Klicken Sie auf + Aktion hinzufügen
2. Wählen Sie Data ops > Custom code
3. Konfigurieren Sie die Aktion:
   • Language: Node.js 20.x
   • Secrets: Leer lassen
   • Properties to include in code:
     • phone (erforderlich)
     • Weitere Felder nach Bedarf, etwa name oder contactId

​

Code-Snippet einfügen

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

• Sendet eine POST-Anfrage an die CloudTalk VoiceAgent API
• Übergibt die Telefonnummer des Kontakts
• Übergibt optional Variablen wie den Vornamen oder die Record ID
• Empfängt die VoiceAgent-Ausgabe an dem von Ihnen gewählten Endpunkt in CloudTalk

​

Authorization-Header generieren

1. Gehen Sie zu https://www.debugbear.com/basic-auth-header-generator
2. Geben Sie Ihren CloudTalk API-Schlüssel und Ihr CloudTalk API Secret ein
   (zu finden in Ihren CloudTalk-Unternehmenseinstellungen).
3. Kopieren Sie den generierten Header. Er sieht etwa so aus: Basic XXXXXXXXX

​

Workflow veröffentlichen und testen

1. Speichern Sie den Custom-Code-Schritt.
2. Klicken Sie auf Review and publish.
3. Entscheiden Sie, ob der Workflow:
   • nur für neue Kontakte ausgeführt werden soll, die die Bedingungen erfüllen, oder
   • auch für Kontakte ausgeführt werden soll, die die Bedingungen bei der Aktivierung des Workflows bereits erfüllen.
4. Lösen Sie den Workflow aus, indem Sie eine Eigenschaft oder die Listenzugehörigkeit eines Testkontakts aktualisieren.

​

Enrollment History prüfen

1. Öffnen Sie den Workflow
2. Gehen Sie zu Performance history > Enrollment history
3. Suchen Sie Ihren Testkontakt in der Liste