OneTrace.pro Hilfe

Integrationen und Kanäle

Eine Integration verbindet OneTrace.pro mit einem externen Dienst: einem Mailserver, einem SMS-Gateway, einem Messenger-Bot, einem Werbekonto oder einem Dateispeicher. Über verbundene Kanäle arbeiten Journeys und Kampagnen, über Plattformen die Zielgruppen-Exporte und Werbe-Conversions, über Quellen der regelmäßige Datenimport.

Den Bereich öffnen Sie im Menü Kommunikation → Integrationen.

Seite „Integrationen“ mit verbundenen Kanälen

Verbundene Integrationen sind nach Art gruppiert. Gibt es mehrere Arten, erscheint über den Karten ein Filter: Alle, Kanäle, CRM usw., jeweils mit Zähler.

Was Sie verbinden können

Eine neue Integration verbinden Sie über die Schaltfläche Integration hinzufügen: Im Fenster sind die Dienste nach Art geordnet, und die Suche findet einen Dienst nach Namen. Die Schaltfläche + neben einer Gruppenüberschrift auf der Seite öffnet das Fenster direkt bei dieser Art.

Kanäle – darüber werden Nachrichten versendet:

Kanal Funktionsweise
E-Mail Mail-Dienst der Plattform – Versand von Ihrer Domain aus dem Bereich Absenderdomains: DKIM-Signatur, Bounces, Beschwerden und Sperrliste funktionieren automatisch; oder Eigener SMTP-Server: Adresse, Port, Verschlüsselung, Benutzername und Passwort. In beiden Fällen geben Sie Absenderadresse und -name an und können die Verfolgung von Öffnungen und Klicks aktivieren. Für einen eigenen SMTP-Server können Sie eine Bounce-Domain und ein Bounce-Postfach angeben, damit unzustellbare E-Mails die Adresse automatisch abmelden. E-Mails von Kunden an die Support-Adresse können Sie im Live-Chat empfangen, siehe Eingehende E-Mails im Chat
SMS Anbieter nach Wahl: SMS.ru, SMSC.ru, Twilio oder die eigene HTTP-API Ihres Gateways. Zustellstatus gehen an die in der Integration angezeigte Adresse
Telegram ein in BotFather erstellter Bot: Das Token genügt, die Adresse für eingehende Nachrichten richtet der Bot selbst ein
Viber (Business-Nachrichten) Nachrichten an Telefonnummern über einen Aggregator: SMSC.ru, Infobip oder eine eigene HTTP-API
Viber-Bot Viber-Bot mit dem Token aus dem Partnerkonto, mit Begrüßung für neue Abonnenten
MAX-Bot Bot im Messenger MAX mit dem Token aus business.max.ru, mit Begrüßung und Schaltfläche „Nummer teilen“, siehe MAX-Bot
VK-Community Nachrichten im Namen der Community mit ihrem Zugriffsschlüssel; ab dem Tarif „Wachstum“, siehe VK-Community
Instagram Direct Nachrichten vom Business-Konto bei Instagram über Ihre Meta-App; ab dem Tarif „Wachstum“, siehe Instagram Direct
Facebook Messenger Nachrichten von einer Facebook-Seite über Ihre Meta-App; ab dem Tarif „Wachstum“, siehe Facebook Messenger
WhatsApp WhatsApp Business Cloud API: Telefonnummer-ID, Konto-ID, Token und App-Secret von Meta
Web Push Browser-Benachrichtigungen; die Schlüssel werden automatisch erzeugt, Abonnements sammelt der Code auf der Website, siehe Website anbinden
Mobile Push Benachrichtigungen in der App für Android und iOS: Paket und Firebase-Dienstkonto, Bundle-ID und APNs-Schlüssel, siehe Mobile Apps
In-App-Nachrichten Fenster, Banner oder Vollbild innerhalb der geöffneten App; ab dem Tarif „Wachstum“, siehe Mobile Apps
Wallet-Karten Kundenkarte in Apple Wallet und Google Wallet: Apple-Zertifikat für die Pass Type ID, Issuer ID und Dienstkonto von Google; ab dem Tarif „Wachstum“, siehe Wallet-Karten
Webhook Anfrage an Ihren Server mit den Nachrichtendaten, etwa für Ihr eigenes Benachrichtigungssystem

Zielgruppen-Exporte – Webhook, S3 (CSV), Meta Custom Audience, Yandex Audiences, VK Ads und Google Ads Customer Match.

Werbe-Conversions – Meta Conversions API, Offline-Conversions von Yandex Metrica und Google Ads, Offline-Ereignisse von VK Ads, siehe Werbe-Conversions.

Datenquellen – Datei per URL, Datei aus S3 und Google Sheet.

Data Warehouses – S3 (NDJSON), Google Cloud Storage, BigQuery, Snowflake, ClickHouse und PostgreSQL für den Export der Projektdaten. Die Gruppe ist im Tarif „Enterprise“ sichtbar.

CRM – amoCRM, Kommo, Bitrix24, HubSpot, Pipedrive, Zoho CRM, Odoo, Salesforce und Microsoft Dynamics 365: Kontakte, Leads und Deals in Profilen und Ereignissen, Journey-Knoten für Deals und Aufgaben, Export von Segmenten zurück ins CRM, siehe CRM. Die Gruppe ist ab dem Tarif „Wachstum“ sichtbar.

Von einer Art können Sie mehrere Integrationen verbinden: zum Beispiel zwei SMTP-Server für Marketing- und Transaktions-E-Mails. In Vorlagen, Journeys und Kampagnen wählen Sie, über welche Integration gesendet wird.

Integration verbinden

  1. Klicken Sie auf Integration hinzufügen und wählen Sie einen Dienst, zum Beispiel E-Mail. Links im Fenster stehen die Arten von Integrationen mit Erläuterung, oben die Suche nach Namen.
  2. Vergeben Sie einen Name – diesen sehen Sie in Vorlagen, Journeys und Exporten, zum Beispiel „Marketing-Mail“.
  3. Füllen Sie die Einstellungen aus. Die Hinweise unter den Feldern erklären, wo Sie Token oder Schlüssel im Konto des Dienstes finden.
  4. Klicken Sie auf Speichern. Um einen anderen Dienst zu wählen, klicken Sie auf Zurück.
  5. Klicken Sie auf der Karte der Integration auf Testen.

Fenster „Neue Integration“: Arten von Integrationen, Suche und Dienste

Dialog zum Verbinden einer E-Mail-Integration

Bei manchen Diensten erscheinen nach dem Speichern zusätzliche Systemfelder in den Einstellungen – etwa Webhook-URL und Prüftoken bei WhatsApp oder Adresse für Zustellstatus bei SMS. Tragen Sie sie im Konto des Dienstes ein, sonst kommen keine Zustellstatus und keine eingehenden Nachrichten an.

Telegram, Viber-Bot, MAX-Bot und WhatsApp empfangen eingehende Nachrichten unter der Adresse Ihrer OneTrace.pro-Installation: Sie muss aus dem Internet per HTTPS erreichbar sein.

MAX-Bot

  1. Erstellen Sie einen Bot auf business.max.ru – einen Bot anlegen können russische juristische Personen, Einzelunternehmer und Selbstständige – und kopieren Sie das Token: „Чат-боты“ (Chatbots) → ⋮ → „Настройки“ (Einstellungen).
  2. Klicken Sie auf Integration hinzufügen, wählen Sie MAX-Bot, fügen Sie das Bot-Token ein und speichern Sie. Die Adresse für eingehende Nachrichten richtet der Bot selbst ein, sein Name erscheint in den Einstellungen.
  3. Legen Sie bei Bedarf eine Begrüßung und den Text der Schaltfläche „Nummer teilen“ fest: Der Bot sendet sie, wenn der Kunde ihn startet.

Dialog zum Verbinden des MAX-Bots

Der Bot kann nur Personen schreiben, die ihn gestartet haben. Mit dem Profil wird der Kunde auf zwei Wegen verknüpft:

  • per Link – Ihr Server erstellt für den angemeldeten Kunden den Link https://max.ru/{bot}?start=… (POST /api/v1/max/link, wie bei Telegram), und der Kunde öffnet den Bot darüber;
  • per Nummer – der Kunde tippt in der Begrüßung auf „Nummer teilen“. Hat MAX bestätigt, dass die Nummer zu seinem Konto gehört, wird der Bot mit dem Profil mit dieser Telefonnummer verknüpft. Eine weitergeleitete fremde Kontaktkarte wird nicht verknüpft.

Das Starten des Bots ist ein Abonnement des Kanals, das Stoppen des Bots oder das Löschen des Chats eine Abmeldung. Kundennachrichten an den Bot werden zum Ereignis max.message und ab dem Tarif „Wachstum“ zu Gesprächen im Live-Chat. Zustellberichte gibt es bei MAX nicht: Eine angenommene Nachricht gilt als zugestellt. Die Regeln von MAX verbieten Werbung in Servicenachrichten.

VK-Community

  1. Öffnen Sie in der Community Community verwalten → Messages und aktivieren Sie die Community-Nachrichten.
  2. Klicken Sie unter Community verwalten → API usage → Access tokens auf „Create token“ und wählen Sie die Rechte „Community management“, „Community messages“, „Photos“ und – wenn Regeln auf Kommentare antworten sollen – „Wall“.
  3. Klicken Sie auf Integration hinzufügen, wählen Sie VK-Community, fügen Sie den Zugriffsschlüssel der Community ein und speichern Sie. OneTrace.pro prüft die Rechte des Schlüssels, fügt den Callback-API-Server selbst in die Einstellungen der Community ein und zeigt Name und Adresse der Community an.
  4. Legen Sie bei Bedarf eine Begrüßung fest: Diese erhält die Person, die Nachrichten der Community erlaubt hat.

Dialog zum Verbinden der VK-Community

Die Community kann nur Personen schreiben, die Nachrichten erlaubt haben, also selbst geschrieben, auf „Allow messages“ geklickt oder einen vk.me-Link geöffnet haben. Das ist das Abonnement des Kanals, das Verbieten von Nachrichten eine Abmeldung. Ihr Server kann die Person mit dem Kundenprofil verknüpfen: POST /api/v1/vk/link erstellt für den angemeldeten Kunden den Link https://vk.me/{community}?ref=…, und dieselbe Markierung können Sie als Schlüssel an das Widget „Allow messages“ übergeben.

In einer Nachricht können Sie Text, ein Bild und Link-Schaltflächen senden. Bilder per URL akzeptiert VK nicht: OneTrace.pro lädt die Datei selbst hoch, einmal pro Kampagne. Nachrichten der Personen werden zum Ereignis vk.message und zu Gesprächen im Live-Chat, Kommentare zu Beiträgen lösen Regeln nach Schlüsselwörtern aus. Beim Löschen der Integration wird auch der Callback-API-Server aus den Einstellungen der Community entfernt.

Instagram Direct

Instagram wird über Ihre eigene App bei Meta verbunden: Für Ihr eigenes Konto ist keine App-Prüfung durch Meta nötig.

  1. Erstellen Sie in Meta for Developers eine App, fügen Sie das Produkt Instagram hinzu und verbinden Sie im Bereich API-Einrichtung mit Instagram-Login das Business-Konto.
  2. Klicken Sie auf „Zugriffstokens generieren“ und kopieren Sie das Token. Benötigt werden die Berechtigungen instagram_business_basic, instagram_business_manage_messages und für Antworten auf Kommentare instagram_business_manage_comments. Kopieren Sie dort auch den Instagram-App-Geheimschlüssel.
  3. Klicken Sie auf Integration hinzufügen, wählen Sie Instagram Direct, fügen Sie Token und Geheimschlüssel ein und speichern Sie. In den Einstellungen erscheinen Webhook-Adresse und Bestätigungstoken.
  4. Tragen Sie Adresse und Token in den Webhook-Einstellungen der App ein (Bereich Instagram). Die Ereignisse des Kontos kann OneTrace.pro selbst abonnieren.

Dialog zum Verbinden von Instagram Direct

Das Token ist 60 Tage gültig, OneTrace.pro verlängert es selbst. Schlägt die Verlängerung fehl, erscheint ein Fehler auf der Karte der Integration: Erstellen Sie ein neues Token und speichern Sie die Integration, bevor das alte abläuft.

Instagram erlaubt Nachrichten an eine Person nur innerhalb von 24 Stunden nach ihrer Nachricht. Kampagnen und Journeys überspringen Personen, die früher geschrieben haben – die Nachricht wird nicht gesendet, das Abonnement bleibt bestehen. Ein Operator im Chat kann auch später antworten, bis zu 7 Tage, wenn die App die Berechtigung Human Agent hat und in der Integration Antworten von Mitarbeitern bis 7 Tage aktiviert ist.

Die erste Nachricht der Person ist ein Abonnement des Kanals, „STOP“ eine Abmeldung. Einen Link zur Unterhaltung mit einer Markierung für die Verknüpfung mit dem Profil erstellt POST /api/v1/instagram/link: https://ig.me/m/{account}?ref=…. Nachrichten und Story-Antworten werden zum Ereignis instagram.message und zu Gesprächen im Live-Chat, Kommentare lösen Regeln nach Schlüsselwörtern aus.

Facebook Messenger

Messenger wird wie Instagram über Ihre eigene App bei Meta verbunden: Für Ihre eigene Seite ist keine App-Prüfung durch Meta nötig.

  1. Erstellen Sie in Meta for Developers eine App und fügen Sie das Produkt Messenger hinzu.
  2. Verbinden Sie im Bereich Messenger → API-Einstellungen die Facebook-Seite und erstellen Sie ein Seiten-Token mit der Berechtigung pages_messaging. Sie benötigen ein unbefristetes Token: OneTrace.pro verlängert es nicht. Kopieren Sie unter App-Einstellungen → Allgemeines das App-Geheimnis.
  3. Klicken Sie auf Integration hinzufügen, wählen Sie Facebook Messenger, fügen Sie Token und Geheimnis ein und speichern Sie. OneTrace.pro findet die Seite, abonniert für sie die Nachrichten und zeigt Webhook-Adresse und Bestätigungstoken an.
  4. Tragen Sie Adresse und Token in den Webhook-Einstellungen der App ein (Bereich Messenger).

Wie Instagram erlaubt Messenger Nachrichten an eine Person nur innerhalb von 24 Stunden nach ihrer Nachricht: Kampagnen und Journeys überspringen Personen, die früher geschrieben haben. Ein Operator im Chat kann bis zu 7 Tage lang antworten, wenn die App die Berechtigung Human Agent hat und in der Integration Antworten von Mitarbeitern bis 7 Tage aktiviert ist.

Die erste Nachricht der Person ist ein Abonnement des Kanals und löst die Begrüßung aus den Einstellungen der Integration aus, „stop“ ist eine Abmeldung. Die Person erhält im Profil die Kennung facebook_psid – die Nummer der Unterhaltung genau mit Ihrer Seite – und den Namen aus Facebook, sofern die Seite ihn sieht. Nachrichten, Fotos und Dateien werden zum Ereignis messenger.message und zu Gesprächen im Live-Chat. Schnellantwort-Schaltflächen des Operators kommen in Messenger als echte Schaltflächen an.

Eingehende E-Mails im Chat

In der E-Mail-Integration empfängt die Gruppe Eingehende E-Mails im Chat E-Mails von Kunden an die Support-Adresse im Live-Chat. Die Antwort des Operators geht über dieselbe Integration in denselben Verlauf. Möglichkeiten:

  • IMAP-Postfach – Server, Port, Verschlüsselung, Login, Passwort und Ordner des Support-Postfachs. Neue E-Mails werden einmal pro Minute abgerufen und als gelesen markiert.
  • Webhook – nach dem Speichern erscheint die Webhook-Adresse mit einem Token. Tragen Sie sie im Mail-Dienst als Adresse für eingehende E-Mails ein. Geeignet sind: Postmark – Inbound webhook, SendGrid – Inbound Parse mit oder ohne „POST the raw, full MIME message“, Mailgun – Routes mit der Aktion forward, Cloudflare Email Workers – durch Weiterleiten der vollständigen E-Mail. Das Token in der Adresse ist geheim: Veröffentlichen Sie die Adresse nicht. Könnte die Adresse in fremde Hände gelangt sein, aktivieren Sie Webhook-Adresse ändern und speichern Sie: Es erscheint eine neue Adresse, die alte nimmt keine E-Mails mehr an. Die Adresse sehen nur Mitglieder, die die Integration verwalten dürfen.

Die Support-Adresse ist für beide Möglichkeiten erforderlich: An sie schreiben die Kunden, und sie ist zugleich die Antwortadresse in den E-Mails der Operatoren.

Test und Status

Die Schaltfläche Testen verbindet sich mit dem Dienst und zeigt das Ergebnis: „Verbindung funktioniert“ mit Details (Name des Bots, Guthaben beim SMS-Anbieter, erreichbarer Bucket) oder „Test fehlgeschlagen“ mit dem Fehlertext. Der Zeitpunkt des letzten Tests steht auf der Karte.

Status Bedeutung
Aktiv die Verbindung ist in Ordnung
Fehler der letzte Test oder die Einrichtung ist fehlgeschlagen; der Fehlertext steht auf der Karte. Korrigieren Sie die Einstellungen und testen Sie erneut
Deaktiviert die Integration wurde mit dem Schalter Aktiviert in ihren Einstellungen ausgeschaltet; darüber werden keine Nachrichten gesendet

Der Test einer SMS-Integration über eine eigene HTTP-API prüft nur, ob die Gateway-Adresse erreichbar ist: Eine echte SMS kostet Geld, prüfen Sie den Versand daher mit einer Testnachricht aus einer Vorlage.

Ändern und löschen

  • Bearbeiten öffnet die Einstellungen. Passwörter, Tokens und Schlüssel werden nach dem Speichern nicht mehr angezeigt: Lassen Sie ein solches Feld leer, um den bisherigen Wert zu behalten.
  • Um den Versand vorübergehend anzuhalten, schalten Sie Aktiviert aus – die Einstellungen bleiben erhalten.
  • Integration löschen – darüber werden keine Nachrichten mehr gesendet, und Exporte und Quellen mit dieser Verbindung stoppen mit einem Fehler. Bei Telegram-, Viber- und MAX-Bots und SMS.ru entfernt die Plattform ihren Webhook selbst. Ist der Dienst nicht erreichbar, erscheint eine Warnung – entfernen Sie den Webhook dann manuell in den Bot-Einstellungen oder im Konto des Dienstes.

Wer Integrationen verwalten darf

Aktion Rollen
Integrationen ansehen „Inhaber“, „Administrator“, „Manager“
Verbinden, ändern, testen und löschen „Inhaber“, „Administrator“

Die Rolle eines Mitglieds lässt sich auf einzelne Integrationen beschränken, siehe Mitglieder und Rollen. Ein solches Mitglied sieht im Bereich nur seine Integrationen und verwaltet nur diese, sofern die Rolle es erlaubt. Eine neue Integration kann es nicht verbinden: Dafür ist eine Berechtigung für das gesamte Projekt nötig. In den Editoren für Vorlagen und Journeys wählt es die Integration weiterhin aus allen im Projekt verbundenen.

Wichtig zu wissen

  • Kanäle prüfen Abonnements und Frequenz nicht selbst: Diese Regeln gelten für alle Kanäle gemeinsam und werden auf der Seite Versandregeln festgelegt.
  • Dort können Sie auch eine nicht benötigte Erweiterung abschalten, etwa WhatsApp. Eine abgeschaltete Erweiterung verschwindet aus den Integrationen, Vorlagen und Journeys des Projekts.
  • Die erste Nachricht in WhatsApp und Massenversand dort sind nur mit von Meta genehmigten Vorlagen möglich; freier Text nur innerhalb von 24 Stunden nach einer Nachricht des Kunden. Meta-Vorlagen, Produktkarussells und WhatsApp-Formulare beschreibt der Artikel Einkaufen in WhatsApp.
  • Beim Mail-Dienst der Plattform legen Sie die Einträge für DKIM, SPF und Bounces einmalig beim Verbinden der Domain an – siehe Absenderdomains. Bei einem eigenen SMTP-Server richten Sie SPF, DKIM und DMARC auf Seiten des Servers und Ihrer Domain ein.