> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Kontakt-Tags automatisieren

> Erstellen Sie einen automatisierten Workflow, der Kontakten, die bestimmte Kriterien erfüllen, Tags hinzufügt

<Note>
  Dieser Artikel zeigt an einem Beispiel, wie Sie mit den Workflow-Automatisierungen von CloudTalk automatisch Tags zu Kontaktprofilen hinzufügen, wenn bestimmte Vorgaben erfüllt sind.
</Note>

**Benutzerebene**: Admin

***

<h2 id="h_1516871ba6">
  Wofür sind Tags nützlich
</h2>

Tags sind ein praktisches Hilfsmittel, um Kontakte für Kampagnen zusammenzufassen, Kontakte aus verschiedenen CRMs zu erkennen, Kontakte zu verwalten und sogar [Kontakte über unterschiedliche Anrufabläufe zu leiten](/de/articles/5763009-caller-based-routing-with-conditions#h_d8706b26a3) – etwa mit einem Bedingungssplitter im Anrufablauf-Designer.

Weitere Informationen zur Verwendung von Tags finden Sie in unserem eigenen Artikel zu Tags [hier.](/de/articles/5440393-contact-tags)

Wenn Sie speziell Informationen zu Kampagnen in CloudTalk suchen, finden Sie diese [hier.](/de/articles/8428838-setting-up-campaigns-legacy-dialer)

<h2 id="h_1397798814">
  Einen Workflow zum automatischen Taggen von Kontakten einrichten
</h2>

*Workflow-Automatisierungen* sind frei gestaltbare, automatisierte Szenarien, die Sie im Dashboard über den Reiter **Konto** finden.

<h4 id="h_a6af840417">
  Beispielfall:
</h4>

Unser Unternehmen organisiert häufig Anrufkampagnen für Leads über ausgehende Anrufe, doch das manuelle Hinzufügen von Tags, um diese neuen Kontakte aus ausgehenden Anrufen zu unterscheiden, bremst den Prozess.

<h4 id="h_181d8ecedd">
  Ziel:
</h4>

Erkennen, ob ein angenommener ausgehender Anruf stattgefunden hat, und in diesem Fall ein neues Tag hinzufügen – `outbound_lead`.

<h3 id="h_66ba6e9141">
  Schritte
</h3>

1. Bevor wir den Workflow erstellen, müssen wir ein eindeutiges API-Schlüsselpaar erzeugen, das wir später verwenden. Navigieren Sie im Dashboard zu **Konto->Einstellungen** und klicken Sie auf die Überschrift *API-Schlüssel*. Erzeugen Sie bei Bedarf über die Schaltfläche **`+ API-Schlüssel hinzufügen`** ein noch nicht genutztes API-Schlüsselpaar. Kopieren Sie diese Werte in ein privates Dokument oder speichern Sie sie anderweitig, um sie später im Prozess zu verwenden.

2. Klicken Sie unter **Konto -> Workflow-Automatisierungen** im [Dashboard](https://dashboard.cloudtalk.io/login) auf die blaue Schaltfläche **`+ Workflow hinzufügen`**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/867eb714a08f-wfa.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=976d1d5b664f8fed422c95b839aa55e2" alt="" width="1698" height="1231" data-path="images/help-center/articles/5846575/867eb714a08f-wfa.png" />
   </Frame>

3. Geben Sie dem Workflow unter **Name** eine aussagekräftige Bezeichnung.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/314fe19c072c-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=19876d066e3e057237a257b75f413d1b" alt="" width="1132" height="438" data-path="images/help-center/articles/5846575/314fe19c072c-image.png" />
   </Frame>

4. Der erste Filterschritt jedes Workflows ist der [Trigger](/de/articles/5648924-triggers). Als Trigger-Objekt wählen wir **Anruf** und als Trigger-Aktion **beendet**. Durch diese Kombination wird unsere Automatisierung immer dann ausgelöst, wenn ein Anruf endet.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/819f36cf6059-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=12af47c8cc7e82f0bf434e85e232d2fc" alt="" width="1650" height="452" data-path="images/help-center/articles/5846575/819f36cf6059-image.png" />
   </Frame>

5. Für unser Ziel in diesem Beispiel müssen wir außerdem einige zusätzliche [Bedingungen](/de/articles/5649346-conditions) festlegen. Die Automatisierung soll nicht nach jedem beendeten Anruf ausgelöst werden. Zunächst wollen wir Anrufe ohne Gesprächszeit ausschließen, da es sich dabei um nicht zustande gekommene Anrufe handelt. Richten Sie diesen Filter ein, indem Sie eine Bedingung mit einem dynamischen Wert erstellen. Klicken Sie in das Feld **Eigenschaft**. Klicken Sie dann rechts im Bereich *Nützliche Daten für Ihre Workflows* auf **`talking_time`**, um das Feld mit dem entsprechenden dynamischen Wert zu füllen. Die resultierende Schreibweise sollte dem Bild unten entsprechen. Wählen Sie als **Operand** die Option **ist größer als** und geben Sie als **Wert** `10` ein, um mögliche Verzögerungen beim Verbindungsaufbau auszugleichen.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/7c096f3d7f42-condition.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=4684453bc0565e17a122612f36834742" alt="" width="2496" height="1122" data-path="images/help-center/articles/5846575/7c096f3d7f42-condition.png" />
   </Frame>

   ```
   Diese Bedingung filtert Anrufe mit einer Gesprächszeit von mehr
   als zehn Sekunden. 
   ```

6. Es sollte eine weitere Bedingung hinzugefügt werden, um ausschließlich nach ausgehenden Anrufen zu filtern. **+ Bedingung hinzufügen**. Füllen Sie das Feld **Eigenschaft** wie bei der vorherigen Bedingung aus, diesmal mit dem dynamischen Wert für **direction**. Wählen Sie als **Operand** die Option **ist gleich**, die nach einer exakten Zeichenübereinstimmung sucht. Geben Sie `outgoing` komplett in Kleinbuchstaben als **Wert** ein. Wenn keine weiteren Bedingungen hinzugefügt werden müssen, können wir auf **`Bestätigen und fortfahren`** klicken.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/18d8998febd1-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=769ac30aa49d70bf52ea00ac268fa5a6" alt="" width="1636" height="1044" data-path="images/help-center/articles/5846575/18d8998febd1-image.png" />
   </Frame>

7. Es gibt drei Arten von [Aktionen](/de/articles/5649782-actions), aus denen Sie wählen können. Für dieses Beispiel senden wir Informationen über die CloudTalk-API zurück. Dafür ist eine Aktion vom Typ **API-Anfrage** erforderlich.

8. Die Aktion **API-Anfrage** ist auf flexible Nutzung ausgelegt; daher müssen Benutzer zusätzliche Dokumentation und Ressourcen heranziehen, um Headers und Werte korrekt zu formatieren. Da dieses Beispiel eine API-Anfrage an die CloudTalk-API stellen soll, können wir uns für die richtige Formatierung an der [CloudTalk API-Referenz](/developers#section/API-Overview) orientieren. Zuerst erwartet das System die Eingabe eines **Endpunkts.** Aufgeschlüsselt besteht der benötigte Endpunkt aus einem Verweis auf die Webadresse bzw. den Token ([`https://my.cloudtalk.io/api`](https://my.cloudtalk.io/api)), einem Verweis auf den Bereich der Adresse, den wir bearbeiten möchten (`contacts`), einem Verweis auf den betreffenden Kontakt (`the contact id`), einem Verweis auf die Funktion, die wir für diesen Kontakt ausführen möchten (`addTags`), und schließlich einem Formattyp (`.json`). Gemäß der oben verlinkten API-Dokumentation**,** sieht das Format unseres **Endpunkts** so aus**:**

   **[`https://my.cloudtalk.io/api/contacts/addTags/{contactId}.json`](https://my.cloudtalk.io/api/contacts/addTags/%7BcontactId%7D.json)**

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/f840d80b4692-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=917debe682a94c2951262e46cdf48268" alt="" width="1562" height="570" data-path="images/help-center/articles/5846575/f840d80b4692-image.png" />
   </Frame>

   Als **Methode** wählen wir **PUT** und bitten das System damit, neue Informationen in die Datenbank zu *legen*, falls sie dort noch nicht vorhanden sind. Beachten Sie außerdem, dass `contactId` im Bild hervorgehoben ist, weil dieser Teil in einen dynamischen Wert geändert werden muss, damit die API auf die tatsächliche ID eines bestimmten Kontakts verweisen kann.

9. Der dynamische Wertverweis, den Sie anstelle von `{contactId}` einfügen, sieht so aus:

   `#{{ event.properties.contacts[0].id }}`

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/3c78e640be1f-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=70ece113751595534df3f8c8f3949ed4" alt="" width="1562" height="570" data-path="images/help-center/articles/5846575/3c78e640be1f-image.png" />
   </Frame>

10. Die meisten API-Aufrufe erfordern eine Form der Autorisierung. Hier kommen die API-Schlüssel ins Spiel, die wir auf unserer Seite **Einstellungen** abgerufen haben. Da wir auf kreative Weise eine Anfrage zurück über die CloudTalk-API selbst stellen, müssen wir einen separaten Tab öffnen und eine API-Plattform wie Workato, SAP Integration oder AWS zu Hilfe nehmen, um das korrekt codierte Format für unseren Autorisierungs-Header zu erstellen. Als Beispiel sehen Sie unten ein Bild davon, wie die Kombination aus Access Key ID und Access Key Secret in der Postman-Oberfläche aussehen kann. Die beiden Schlüssel werden als Werte für die Basic-Autorisierung eingegeben; das Ergebnis ist ein formatierter Header mit einem Schlüssel und einem verschlüsselten Zeichenfolgen-Wert.

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/8c4d72e061a4-enter-keys-on-postman.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=cd5997e183ec68ccbda09cb415bcd780" alt="" width="1855" height="613" data-path="images/help-center/articles/5846575/8c4d72e061a4-enter-keys-on-postman.png" />
    </Frame>

    ```
    Hinweis: Die Navigation auf der Webseite und die Feldnamen unterscheiden sich je nach verwendeter API-Plattform leicht. 
    ```

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/7ce2eb17267c-example-value-postman.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=ee499f6629d400fc7d2c07823ca93c71" alt="" width="1347" height="353" data-path="images/help-center/articles/5846575/7ce2eb17267c-example-value-postman.png" />
    </Frame>

11. Sobald wir ein Schlüssel:Wert-Paar im richtigen Format erhalten haben, tragen wir diese Zeichenfolgen in die entsprechend benannten Felder unter *Headers* in unserer CloudTalk-API-Anfrage ein.

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/ef4d80e7f64c-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=11dcf1a66708b3006ac2c8f8c1771fe7" alt="" width="1562" height="512" data-path="images/help-center/articles/5846575/ef4d80e7f64c-image.png" />
    </Frame>

12. Im Bereich *Werte* der Anfrage legen wir den Namen des Tags fest, das beim Auslösen der Automatisierung hinzugefügt werden soll. Geben Sie als **Schlüssel** `tags.0` ein, um auf die Tag-Liste zu verweisen. Geben Sie den gewünschten Tag-Namen in das Feld **Wert** ein.

    <Frame>
      <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/275b074eb210-image.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=0bd70ac3d34711f35204c9b181a52787" alt="" width="1562" height="512" data-path="images/help-center/articles/5846575/275b074eb210-image.png" />
    </Frame>

13. Wenn keine weiteren Headers oder Werte hinzugefügt werden müssen, können wir unsere **Aktion API-Anfrage** überprüfen und sicherstellen, dass alle Feldeinträge das richtige Format haben. Klicken Sie anschließend auf **`Bestätigen und fortfahren`**.

14. Sobald wir die Automatisierung gespeichert und auf *Aktiv* gesetzt haben, kann sie loslaufen. Wenn die Bedingungen erfüllt sind, wird unser Tag `outbound_lead` automatisch zu Kontaktprofilen hinzugefügt, die dieses Tag noch nicht haben.

***

<h2 id="h_ae059d4dd2">
  Warum funktioniert meine Automatisierung nicht?
</h2>

Testen Sie ein Szenario, das die Automatisierung auslösen sollte, und prüfen Sie zur Kontrolle den Zähler „Ausführungen diesen Monat“.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/Cdyt2I6w7OABieBC/images/help-center/articles/5846575/dff205e852cd-wfa.png?fit=max&auto=format&n=Cdyt2I6w7OABieBC&q=85&s=18ea4131280a109230770fe612e10353" alt="" width="2048" height="252" data-path="images/help-center/articles/5846575/dff205e852cd-wfa.png" />
</Frame>

Prüfen Sie je nachdem, ob der Zähler nach dem Aktualisieren der Seite gestiegen oder gesunken ist, die folgenden häufigen Szenarien darauf, ob sie auf Ihre Situation zutreffen. Besteht das Problem weiterhin, wenden Sie sich an das CloudTalk-Support-Team.

* ### Der Zähler „Ausführungen diesen Monat“ steigt nicht

  Das bedeutet, dass die Automatisierung nicht ausgelöst wird, die festgelegten Bedingungen also nicht erfüllt werden. Stellen Sie sicher, dass die Bedingungen logisch sind und die Ereignisse einschließen, die die Automatisierung auslösen sollen.

* ### Der Zähler „Ausführungen diesen Monat“ steigt, aber meine API-Aktion wird nicht ausgeführt

  Das liegt höchstwahrscheinlich an einem Fehler in der API-Struktur im Aktionsschritt der Automatisierung. Prüfen Sie, ob:

  * der Endpunkt wie in den Schritten oben gezeigt korrekt formatiert ist

  * dynamische Werte anstelle von Formatierungsplatzhaltern wie „`ContactId`“ verwendet werden

  * ein Autorisierungs-Header korrekt angewendet wurde

  * die **Schlüssel**-Zeichenfolgen im Bereich *Werte* der Anfrage in dem [vom API-Interpreter erwarteten Format](/developers#tag/Tags/paths/~1tags~1index.json/get) geschrieben sind

***

*Brauchen Sie Hilfe oder haben Sie eine Frage?* Melden Sie sich einfach über unser [Support-Portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da.


## Related topics

- [Kontakt-Tags](/de/articles/5440393-contact-tags.md)
- [Anruf-Tags](/de/articles/5854602-call-tags.md)
- [Kontakte verwalten](/de/articles/7056354-managing-contacts.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.