Trello | ElevenLabs Documentation

Je receptionist kan een kaart toevoegen aan een Trello-lijst wanneer een beller om een terugbelverzoek, een offerte of iets anders vraagt waarop je team moet terugkomen. Een webhooktool maakt de kaart via de REST API van Trello.

Voordat je begint

Vraag een API-sleutel aan

Ga naar het Power-Up-beheerportaal, maak een Power-Up voor je workspace (de naam maakt niet uit), open het tabblad Trello Auth en selecteer Generate a new API key.

Genereer een token

Selecteer de link Token naast je API-sleutel, of open deze URL in een browser met je API-sleutel in plaats van API_KEY:

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

Selecteer Allow en kopieer het token. Hiermee kan elke board die jij kunt openen worden gelezen en gewijzigd, dus overweeg het te genereren vanuit een account dat alleen lid is van het board dat je nodig hebt.

Zoek de lijst-ID

Open het board in je browser, voeg .json toe aan het einde van de URL en laad de pagina. Zoek naar de naam van de lijst; de waarde van id ernaast is de lijst-ID.

Maak de webhooktool

Ga naar Integrations, selecteer Add integration en kies Webhook Tool.

Veld	Waarde
Naam	`create_trello_card`
Beschrijving	”Maak een kaart voor het team wanneer je de beller een follow-up belooft, of wanneer de beller om iets vraagt dat het team moet afhandelen.”
Methode	POST
URL	`https://api.trello.com/1/cards?idList=LIST_ID`
Requestheaders	`Authorization`: `OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`
Bodyparameters	`name` (string, vereist): “Korte titel met de naam van de beller en wat diegene nodig heeft, bijvoorbeeld: Bel Jane Doe terug over een offerte.” `desc` (string, vereist): “De naam en het telefoonnummer van de beller, en de details van het verzoek.”
Toewijzen aan agents	Receptionist

Voer ?idList=LIST_ID in het URL-veld zelf in, met je lijst-ID. Voeg idList niet toe als queryparameter: queryparameters worden ingevuld door de AI, terwijl tekst in de URL precies wordt verzonden zoals geschreven.

Trello accepteert de sleutel en het token ook in de URL, als &key=API_KEY&token=TOKEN. Dat werkt ook, maar de header houdt ze buiten de URL. Als je ze in de URL zet, beschouw dan de hele URL als een geheim.

Selecteer Enable en test je receptionist door om een terugbelverzoek te vragen. De kaart verschijnt onderaan de lijst.

Problemen oplossen

Probleem	Wat je moet controleren
Trello geeft 401 terug	Controleer de header: de sleutel en het token moeten allebei tussen dubbele aanhalingstekens staan, gescheiden door een komma en een spatie. Genereer het token opnieuw als het is ingetrokken.
`invalid value for idList`	De lijst-ID in de URL is onjuist. Gebruik de `id` van de lijst, niet die van het board.
Trello geeft 404 terug of geen toegang	De gebruiker van het token moet lid zijn van het board.
De receptionist maakt nooit kaarten	Zorg dat de beschrijving van de tool de situaties noemt waarin deze een kaart moet maken.