Byg Threll ind i de systemer, du allerede har
Ét API-kald starter en samtale. Webhooks lader dit fagsystem være med undervejs. Og med MCP kan AI-assistenten gøre arbejdet for dig. Her er det vigtigste – dokumentationen har resten.
Passer ind, hvor du allerede arbejder
Du behøver ikke bygge noget nyt omkring Threll. Dit arbejdsflow siger til, når der skal ringes, og resultatet lander, hvor det hører hjemme.
- 1
Én API-nøgle
Opret en nøgle under Indstillinger → Udvikler, og send den i headeren x-api-key. Mere skal der ikke til for at autentificere.
- 2
Ét kald starter samtalen
Angiv, hvem der skal ringes til, hvilken agent der ringer, og hvad målet er. Opkaldet sættes i kø med det samme eller planlægges til et bestemt tidspunkt.
- 3
Hændelser direkte til dit endpoint
Status, transskription og slutsignal streames til en webhook, du ejer, mens samtalen står på.
- 4
Resultatet tilbage i dit system
Hent analyse, næste skridt, transskription og lydoptagelse via REST, når efterbehandlingen er færdig.
curl -X POST https://api.threll.io/v1/accounts/$ACCOUNT_ID/phone-calls \
-H "x-api-key: $THRELL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workerId": "2b7d9a4c-6e3f-48a1-9c5d-8e0b4f2a1c8d",
"phoneNumber": "+4799999999",
"context": "Qualify this demo request. Goal: book a meeting.",
"customer": {
"type": "lead",
"firstName": "Kari",
"externalId": "crm-8841"
}
}'Sådan ser en samtale ud udefra
- Synkron
call.worker_requestFør agenten svarer: giv den friske data om den, der ringer.
- Asynkron
call.status_updateOpkaldet ringer, er i gang eller er afsluttet.
- Asynkron
call.transcriptHver replik sendes, så snart den er sagt.
- Synkron
call.tool_callAgenten har brug for noget fra dit system. Samtalen venter på svaret.
- Asynkron
call.endedSidste hændelse. Nu kan du hente resultatet.
Forbind dine fagsystemer
CRM, journal, booking eller ERP: agenten henter og skriver data i dit system, mens den taler med kunden. Du bestemmer, hvad den har adgang til.
- Før samtalen
Giv agenten kontekst
Slå den, der ringer, op i CRM'et, og send kundehistorik, åbne sager eller tidligere aftaler med. Så svarer agenten, som om den kender kunden.
call.worker_requestSynkron - Under samtalen
Lad agenten gøre arbejdet
Tjek ledige tider, slå en ordre op eller registrér en sag: agenten kalder de værktøjer, du definerer, og du svarer fra dit system.
call.tool_callSynkron - Efter samtalen
Synkronisér resultatet
Opdatér kundekortet, opret manglende kontakter, og send næste skridt – som »book møde« eller »eskalér til et menneske« – videre til sagsbehandlingen.
call.endedAsynkron
app.post('/threll/webhooks', async (req, res) => {
const { type, data } = req.body;
switch (type) {
case 'call.worker_request': {
const customer = await crm.findByPhone(data.customer.number);
return res.json({ context: customer?.summary ?? 'New caller' });
}
case 'call.tool_call': {
const account = await erp.findAccount(data.arguments.accountNumber);
return res.json({ result: account ?? { error: 'not found' } });
}
case 'call.ended':
queue.push({ syncCall: data.callId });
return res.sendStatus(200);
default:
return res.sendStatus(200);
}
});Trygt at bygge på
- Hver webhook er signeret med HMAC-SHA256 i X-Threll-Signature, så du ved, at den kommer fra Threll.
- X-Threll-Event-Id gør det nemt at se bort fra hændelser, der leveres igen.
- Synkrone hændelser venter på dit svar, så hold opslaget under et sekund – kunden venter i telefonen.
Færdige integrationer
- Cal.com
- EasyPractice
- Magento
- Intercom
- Crisp
- GoHighLevel
- Gastroplanner
- Shipmondo
- Vipps
Bruger du noget andet, forbinder du det selv med webhooks og egne værktøjer – uden at vente på os.
Brug Threll fra AI-assistenten
Threll har en MCP-server, så Claude og andre MCP-klienter kan styre agenterne, planlægge opkald og søge i historikken – med præcis den adgang, brugeren godkender.
https://mcp.threll.ioKlar på et par minutter
- 1
Tilføj en brugerdefineret connector
Indsæt serveradressen i klienten. Resten af konfigurationen findes automatisk.
- 2
Log ind, og godkend adgang
Login sker med OAuth 2.1. Ingen API-nøgler at gemme, og adgangen kan tilbagekaldes når som helst.
- 3
Værktøjerne er klar
Assistenten får kun de værktøjer, brugeren har givet adgang til – for eksempel kontoadministration eller en bestemt integration.
Et menneske bekræfter
- Opkald forberedes først og ringes først ud, når nogen bekræfter.
- Op til 100 opkald kan forberedes og bekræftes samlet.
- Planlagte opkald kan annulleres, før de ringes ud.
Bed Harald ringe til de her fem leads i morgen klokken ni.
Fem opkald fra Harald er klar til i morgen kl. 09.00. Skal jeg sætte dem i gang?
{
"mcpServers": {
"threll": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.threll.io/"]
}
}
}Alt, du skal bruge for at komme videre
Guides, referencer og eksempler ligger på developers.threll.ai.
- Kom i gangAPI-nøgle, første kald og grundbegreberne. (åbnes i nyt vindue)
- Arbejd med REST-API'etStart opkald, håndtér fejl og hent resultater. (åbnes i nyt vindue)
- WebhooksSynkrone og asynkrone hændelser, signering og genforsøg. (åbnes i nyt vindue)
- Udgående fra ende til andenFra API-kald til færdig CRM-post. (åbnes i nyt vindue)
- Indgående fra ende til andenGenkend den, der ringer, og send næste skridt videre. (åbnes i nyt vindue)
- Telefoni og numreForbind egne numre via SIP eller Twilio. (åbnes i nyt vindue)
- Planlagte opkaldRing på et bestemt tidspunkt, og annullér ved behov. (åbnes i nyt vindue)
- Forbind AI-agenter (MCP)OAuth, adgange og opsætning i klienten. (åbnes i nyt vindue)
- REST-API-referenceAlle endpoints, felter og svar. (åbnes i nyt vindue)
- Webhook-referenceAlle hændelser, og hvad de indeholder. (åbnes i nyt vindue)
- MCP-referenceAlle værktøjer, og hvad de gør. (åbnes i nyt vindue)
- Grænser og fejlRate limits, fejlkoder, og hvordan du håndterer dem. (åbnes i nyt vindue)
Brug for hjælp til integrationen?
Book et møde, så gennemgår vi opsætningen sammen – eller stil et hurtigt spørgsmål i chatten.
Spørgsmål fra udviklere
Finder du ikke svaret her, så spørg os i chatten.
Du opretter API-nøgler i platformen under Indstillinger → Udvikler. Nøglen sendes i headeren x-api-key i hvert kald.
Nej. Du tilføjer MCP-serveren som en connector i AI-assistenten og logger ind. Adgangen godkender du selv, og du kan tilbagekalde den, når du vil.
Hver forespørgsel har headeren X-Threll-Signature, en HMAC-SHA256 af det rå indhold signeret med hemmeligheden for dit abonnement. Tjek den, før du læser indholdet.
Så definerer du egne værktøjer og svarer på dem fra dit webhook-endpoint. Agenten kan dermed læse fra og skrive til ethvert system, du har et API til. Vil du have hjælp, så book et møde med os.