Bygg Threll inn i systemene du allerede har
Ett API-kall starter en samtale. Webhooks gir fagsystemet ditt ordet underveis. Og med MCP kan KI-assistenten gjøre jobben for deg. Her er det viktigste – dokumentasjonen har resten.
Passer inn der du allerede jobber
Du trenger ikke bygge noe nytt rundt Threll. Arbeidsflyten din sier fra når det skal ringes, og resultatet havner der det hører hjemme.
- 1
Én API-nøkkel
Opprett en nøkkel under Innstillinger → Utvikler og send den i headeren x-api-key. Det er alt som skal til for å autentisere.
- 2
Ett kall starter samtalen
Send hvem som skal ringes, hvilken agent som ringer og hva målet er. Samtalen legges i kø med én gang, eller planlegges til et gitt tidspunkt.
- 3
Hendelser rett til endepunktet ditt
Status, transkripsjon og sluttsignal strømmer til en webhook du eier, mens samtalen pågår.
- 4
Resultatet tilbake i systemet ditt
Hent analyse, neste steg, transkripsjon og lydopptak over REST når samtalen er ferdigbehandlet.
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"
}
}'Slik ser en samtale ut fra utsiden
- Synkron
call.worker_requestFør agenten svarer: gi den ferske data om hvem som ringer.
- Asynkron
call.status_updateSamtalen ringer, er i gang eller er avsluttet.
- Asynkron
call.transcriptHver replikk sendes så snart den er ferdig sagt.
- Synkron
call.tool_callAgenten trenger noe fra systemet ditt. Samtalen venter på svaret.
- Asynkron
call.endedSiste hendelse. Nå kan du hente resultatet.
Koble til fagsystemene dine
CRM, journal, booking eller ERP: agenten henter og skriver data i systemet ditt mens den snakker med kunden. Du bestemmer hva den har tilgang til.
- Før samtalen
Gi agenten kontekst
Slå opp innringeren i CRM-et og send med kundehistorikk, åpne saker eller tidligere avtaler. Da svarer agenten som om den kjenner kunden.
call.worker_requestSynkron - Under samtalen
La agenten gjøre jobben
Sjekke ledige timer, slå opp en ordre eller registrere en sak: agenten kaller verktøyene du definerer, og du svarer fra fagsystemet.
call.tool_callSynkron - Etter samtalen
Synk resultatet
Oppdater kundekortet, opprett manglende kontakter og send neste steg – som «book møte» eller «eskaler til menneske» – videre til saksbehandlingen.
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 å bygge på
- Hver webhook er signert med HMAC-SHA256 i X-Threll-Signature, så du vet at den kommer fra Threll.
- X-Threll-Event-Id gjør det enkelt å se bort fra hendelser som leveres på nytt.
- Synkrone hendelser venter på svaret ditt, så hold oppslaget under ett sekund – kunden venter i telefonen.
Ferdige integrasjoner
- Cal.com
- EasyPractice
- Magento
- Intercom
- Crisp
- GoHighLevel
- Gastroplanner
- Shipmondo
- Vipps
Bruker du noe annet, kobler du det til selv med webhooks og egne verktøy – uten å vente på oss.
Bruk Threll fra KI-assistenten
Threll har en MCP-server, så Claude og andre MCP-klienter kan styre agentene, planlegge samtaler og slå opp i historikken – med de tilgangene brukeren selv godkjenner.
https://mcp.threll.ioOppsett på et par minutter
- 1
Legg til en egendefinert connector
Lim inn serveradressen i klienten. Resten av konfigurasjonen oppdages automatisk.
- 2
Logg inn og godkjenn tilgang
Innloggingen skjer med OAuth 2.1. Ingen API-nøkler å lagre, og tilgangen kan trekkes tilbake når som helst.
- 3
Verktøyene er klare
Assistenten får bare verktøyene brukeren har gitt tilgang til – for eksempel kontoadministrasjon eller en bestemt integrasjon.
Et menneske bekrefter
- Samtaler forberedes først og ringes først når noen bekrefter.
- Opptil 100 samtaler kan forberedes og bekreftes samlet.
- Planlagte samtaler kan kanselleres før de ringes ut.
Be Harald ringe disse fem leadsene i morgen klokka ni.
Fem samtaler er klare for i morgen kl. 09.00 fra Harald. Skal jeg sette dem i gang?
{
"mcpServers": {
"threll": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.threll.io/"]
}
}
}Alt du trenger for å komme videre
Guider, referanser og eksempler ligger på developers.threll.ai.
- Kom i gangAPI-nøkkel, første kall og grunnbegrepene. (åpnes i nytt vindu)
- Jobbe med REST-API-etStart samtaler, håndter feil og hent resultater. (åpnes i nytt vindu)
- WebhooksSynkrone og asynkrone hendelser, signering og retry. (åpnes i nytt vindu)
- Utgående fra ende til endeFra API-kall til ferdig CRM-oppføring. (åpnes i nytt vindu)
- Innkommende fra ende til endeKjenn igjen innringeren og rut neste steg. (åpnes i nytt vindu)
- Telefoni og numreKoble til egne numre via SIP eller Twilio. (åpnes i nytt vindu)
- Planlagte samtalerRing på et bestemt tidspunkt, og avbryt ved behov. (åpnes i nytt vindu)
- Koble til KI-agenter (MCP)OAuth, tilganger og oppsett i klienten. (åpnes i nytt vindu)
- REST-API-referanseAlle endepunkter, felter og svar. (åpnes i nytt vindu)
- Webhook-referanseAlle hendelser og hva de inneholder. (åpnes i nytt vindu)
- MCP-referanseAlle verktøy og hva de gjør. (åpnes i nytt vindu)
- Grenser og feilRate limits, feilkoder og hvordan du håndterer dem. (åpnes i nytt vindu)
Trenger du hjelp med integrasjonen?
Book et møte, så går vi gjennom oppsettet sammen – eller still et kjapt spørsmål i chatten.
Spørsmål fra utviklere
Finner du ikke svaret her, spør oss i chatten.
Du oppretter API-nøkler i plattformen under Innstillinger → Utvikler. Nøkkelen sendes i headeren x-api-key på hvert kall.
Nei. Du legger til MCP-serveren som en connector i KI-assistenten og logger inn. Tilgangene godkjenner du selv, og du kan trekke dem tilbake når du vil.
Hver forespørsel har headeren X-Threll-Signature, en HMAC-SHA256 av råinnholdet signert med hemmeligheten for abonnementet ditt. Sjekk den før du leser innholdet.
Da definerer du egne verktøy og svarer på dem fra webhook-endepunktet ditt. Agenten kan dermed slå opp i og skrive til hvilket som helst system du har et API mot. Vil du ha hjelp, book et møte med oss.