Trello | ElevenLabs Documentation

Ihre Rezeption kann einer Trello-Liste eine Karte hinzufügen, wenn Anrufende um einen Rückruf, ein Angebot oder etwas anderes bitten, dem Ihr Team nachgehen soll. Ein Webhook-Tool erstellt die Karte über die REST API von Trello.

Bevor Sie beginnen

API-Schlüssel abrufen

Gehen Sie zum Power-Up-Verwaltungsportal, erstellen Sie ein Power-Up für Ihren Workspace (der Name spielt keine Rolle), öffnen Sie den Tab Trello Auth und wählen Sie Generate a new API key.

Token generieren

Wählen Sie den Link Token neben Ihrem API-Schlüssel oder öffnen Sie diese URL mit Ihrem API-Schlüssel anstelle von API_KEY im Browser:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY

Wählen Sie Allow und kopieren Sie das Token. Es kann alle Boards lesen und ändern, auf die Sie Zugriff haben. Generieren Sie es daher am besten über ein Konto, das nur Mitglied des benötigten Boards ist.

Listen-ID finden

Öffnen Sie das Board im Browser, fügen Sie .json ans Ende der URL an und laden Sie die Seite. Suchen Sie nach dem Namen der Liste; der daneben stehende Wert id ist die Listen-ID.

Webhook-Tool erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool.

Feld	Wert
Name	`create_trello_card`
Beschreibung	”Erstelle für das Team eine Karte, wenn du Anrufenden eine Nachverfolgung zusagst oder sie um etwas bitten, das das Team erledigen muss.”
Methode	POST
URL	`https://api.trello.com/1/cards?idList=LIST_ID`
Anfrage-Header	`Authorization`: `OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`
Body-Parameter	`name` (String, erforderlich): “Kurzer Titel mit dem Namen der anrufenden Person und ihrem Anliegen, zum Beispiel: Jane Doe wegen eines Angebots zurückrufen.” `desc` (String, erforderlich): “Name und Telefonnummer der anrufenden Person sowie die Details ihrer Anfrage.”
Agenten zuweisen	Rezeption

Geben Sie ?idList=LIST_ID mit Ihrer Listen-ID direkt in das URL-Feld ein. Fügen Sie idList nicht als Abfrageparameter hinzu: Abfrageparameter werden von der KI ausgefüllt, während Text in der URL exakt wie geschrieben gesendet wird.

Trello akzeptiert Schlüssel und Token auch in der URL, als &key=API_KEY&token=TOKEN. Das funktioniert ebenfalls, aber der Header hält sie aus der URL heraus. Wenn Sie sie in die URL einfügen, behandeln Sie die gesamte URL als vertraulich.

Wählen Sie Enable und testen Sie Ihre Rezeption, indem Sie um einen Rückruf bitten. Die Karte erscheint am Ende der Liste.

Fehlerbehebung

Problem	Prüfen Sie
Trello gibt 401 zurück	Prüfen Sie den Header: Schlüssel und Token müssen jeweils in doppelten Anführungszeichen stehen und durch ein Komma mit Leerzeichen getrennt sein. Generieren Sie das Token neu, wenn es widerrufen wurde.
`invalid value for idList`	Die Listen-ID in der URL ist falsch. Verwenden Sie die `id` der Liste, nicht die des Boards.
Trello gibt 404 zurück oder kein Zugriff	Der Nutzer des Tokens muss Mitglied des Boards sein.
Die Rezeption erstellt nie Karten	Sorgen Sie dafür, dass die Beschreibung des Tools die Situationen nennt, in denen es eine Karte erstellen soll.