Zum Hauptinhalt springen

Integrationsleitfaden: HubSpot

Dieser Leitfaden zeigt Ihnen, wie Sie mithilfe von ClickSend und individualisierbaren Code-Aktionen in Workflows automatisch SMS-Nachrichten aus HubSpot versenden.

Heute aktualisiert

Voraussetzungen

Bevor Sie Ihr Abenteuer starten, benötigen Sie Folgendes:

  • Ein ClickSend-Konto

  • Ein HubSpot-Konto

  • HubSpot Operations Hub Professional oder höher – Abonnements ansehen


Schritt 1: Einen Workflow-Trigger erstellen

  1. Gehen Sie in HubSpot zu Automatisierungen > Workflows.

  2. Klicken Sie auf Workflow erstellen.

  3. Wählen Sie Kontaktbasiert > Leerer Workflow, geben Sie einen Namen ein und klicken Sie dann auf Weiter.

  4. Klicken Sie auf Trigger einrichten und definieren Sie dann, wie Kontakte in den Workflow eintreten.

    • Beispiel: Verwenden Sie einen Filter wie "Telefonnummer enthält kein 'a'", um alle gültigen Telefonnummern einzuschließen.

  5. Klicken Sie auf Filter anwenden, testen Sie bei Bedarf die Kriterien und klicken Sie dann auf Speichern.


Schritt 2: Eine private App in HubSpot erstellen

  1. Gehen Sie in einem neuen Tab zu Einstellungen > Integrationen > Private Apps.

  2. Klicken Sie auf Private App erstellen.

  3. Legen Sie den Namen und die Beschreibung der App fest.

  4. Wählen Sie die erforderlichen Bereiche aus (CRM-Objekte > Kontakte – Lesezugriff).

  5. Klicken Sie auf App erstellen und kopieren Sie das Zugriffs-Token für später.


Schritt 3: Die Telekommunikationsdienst-Aktion in Ihrem Workflow hinzufügen

  1. Zurück im Workflow-Editor klicken Sie auf den +-Button, um eine Aktion hinzuzufügen.

  2. Wählen Sie Individualisierbar-Code aus der Aktionsliste.

  3. Im Bereich Secrets:

    1. Klicken Sie auf Choose a secret > Add secret

    2. Fügen Sie die folgenden Geheimnisse hinzu:

      • HPKEY – Ihr HubSpot Private App-Token

      • CSUSERNAME – Ihr ClickSend-Benutzername (aus dem Dashboard)

      • CSKEY – Ihr ClickSend API-Schlüssel


Schritt 4: Den Code hinzufügen und anpassen

  1. Entfernen Sie den vorhandenen Codeblock.

  2. Stellen Sie sicher, dass HubSpot Client v3 ausgewählt ist.

  3. Kopieren Sie den folgenden Code und fügen Sie ihn ein:

const hubspot = require('@hubspot/api-client');
var axios = require('axios');

exports.main = async (event, callback) => {
try {
const username = process.env.CSUSERNAME;
const key = process.env.CSKEY;
const hubspotClient = new hubspot.Client({ accessToken: process.env.HPKEY });

const result = Buffer.from(`${username}:${key}`).toString('base64');
const contact = await hubspotClient.crm.contacts.basicApi.getById(
event.object.objectId,
['phone', 'firstname', 'lastname']
);

const phone = contact.body.properties.phone;
const firstName = contact.body.properties.firstname || '';
const lastName = contact.body.properties.lastname || '';
const message = `Hallo ${firstName}, dies ist eine Testnachricht von HubSpot.`; // Bei Bedarf anpassen

const data = JSON.stringify({
messages: [{
body: message,
to: phone,
from: "", // Optional: Absender-ID hinzufügen
source: "Hubspot"
}]
});

const config = {
method: 'post',
url: 'https://rest.clicksend.com/v3/sms/send',
headers: {
'Content-Type': 'application/json',
'Authorization': `Basic ${result}`
},
data: data
};

await axios(config);
} catch (err) {
console.error(err);
throw err;
}

callback({
outputFields: {
email: event.inputFields['email'],
phone: event.inputFields['phone'],
},
});
};

4. Klicken Sie auf Speichern.


Testen Sie Ihren Workflow (optional)

  1. Klicken Sie im Workflow auf Testen.

  2. Wählen Sie einen Kontakt mit einer Telefonnummer aus und führen Sie den Test durch.

  3. Wenn erfolgreich, sehen Sie "SUCCESS" in der Ausgabe.


Schritt 5: Überprüfen und veröffentlichen

  1. Klicken Sie auf Überprüfen und veröffentlichen.

  2. Überprüfen Sie die Optionen für Aufnahme, Abmeldung und Timing.

  3. Klicken Sie auf Einschalten, um den Workflow zu aktivieren.


Fertig!

Ihr Workflow ist jetzt live und wird jedes Mal einen Telekommunikationsdienst über ClickSend versenden, wenn ein Kontakt Ihre Trigger-Bedingungen erfüllt.

Für Hilfe bei der Fehlerbehebung [nehmen Sie Kontakt mit unserem Supportteam auf.]

Hat dies deine Frage beantwortet?