Bygg in Threll i systemen du redan har
Ett API-anrop startar ett samtal. Webhooks låter ditt verksamhetssystem vara med medan det pågår. Och med MCP kan AI-assistenten göra jobbet åt dig. Här är det viktigaste – dokumentationen har resten.
Passar in där du redan jobbar
Du behöver inte bygga något nytt runt Threll. Ditt arbetsflöde säger till när det ska ringas, och resultatet hamnar där det hör hemma.
- 1
En API-nyckel
Skapa en nyckel under Inställningar → Utvecklare och skicka den i headern x-api-key. Mer krävs inte för att autentisera.
- 2
Ett anrop startar samtalet
Ange vem som ska ringas, vilken agent som ringer och vad målet är. Samtalet köas direkt eller schemaläggs till en viss tidpunkt.
- 3
Händelser direkt till din endpoint
Status, transkription och slutsignal strömmar till en webhook du äger medan samtalet pågår.
- 4
Resultatet tillbaka i ditt system
Hämta analys, nästa steg, transkription och ljudinspelning via REST när efterbearbetningen är klar.
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å ser ett samtal ut utifrån
- Synkron
call.worker_requestInnan agenten svarar: ge den färsk data om den som ringer.
- Asynkron
call.status_updateSamtalet ringer, pågår eller är avslutat.
- Asynkron
call.transcriptVarje replik skickas så fort den är sagd.
- Synkron
call.tool_callAgenten behöver något från ditt system. Samtalet väntar på svaret.
- Asynkron
call.endedSista händelsen. Nu kan du hämta resultatet.
Koppla ihop dina verksamhetssystem
CRM, journal, bokning eller ERP: agenten hämtar och skriver data i ditt system medan den pratar med kunden. Du bestämmer vad den har åtkomst till.
- Före samtalet
Ge agenten kontext
Slå upp den som ringer i CRM:et och skicka med kundhistorik, öppna ärenden eller tidigare bokningar. Då svarar agenten som om den känner kunden.
call.worker_requestSynkron - Under samtalet
Låt agenten göra jobbet
Kolla lediga tider, slå upp en order eller registrera ett ärende: agenten anropar verktygen du definierar, och du svarar från ditt system.
call.tool_callSynkron - Efter samtalet
Synka resultatet
Uppdatera kundkortet, skapa saknade kontakter och skicka nästa steg – som ”boka möte” eller ”eskalera till människa” – vidare till ärendehanteringen.
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);
}
});Tryggt att bygga på
- Varje webhook är signerad med HMAC-SHA256 i X-Threll-Signature, så du vet att den kommer från Threll.
- X-Threll-Event-Id gör det enkelt att bortse från händelser som levereras igen.
- Synkrona händelser väntar på ditt svar, så håll uppslaget under en sekund – kunden väntar i telefonen.
Färdiga integrationer
- Cal.com
- EasyPractice
- Magento
- Intercom
- Crisp
- GoHighLevel
- Gastroplanner
- Shipmondo
- Vipps
Använder du något annat kopplar du in det själv med webhooks och egna verktyg – utan att vänta på oss.
Använd Threll från AI-assistenten
Threll har en MCP-server, så Claude och andra MCP-klienter kan styra agenterna, schemalägga samtal och söka i historiken – med exakt den åtkomst användaren godkänner.
https://mcp.threll.ioKlart på ett par minuter
- 1
Lägg till en anpassad connector
Klistra in serveradressen i klienten. Resten av konfigurationen upptäcks automatiskt.
- 2
Logga in och godkänn åtkomst
Inloggningen sker med OAuth 2.1. Inga API-nycklar att lagra, och åtkomsten kan återkallas när som helst.
- 3
Verktygen är redo
Assistenten får bara de verktyg användaren har gett åtkomst till – till exempel kontoadministration eller en viss integration.
En människa bekräftar
- Samtal förbereds först och rings först när någon bekräftar.
- Upp till 100 samtal kan förberedas och bekräftas samtidigt.
- Schemalagda samtal kan avbrytas innan de rings upp.
Be Harald ringa de här fem leadsen i morgon klockan nio.
Fem samtal från Harald är klara för i morgon kl. 09.00. Ska jag sätta igång dem?
{
"mcpServers": {
"threll": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.threll.io/"]
}
}
}Allt du behöver för att komma vidare
Guider, referenser och exempel finns på developers.threll.ai.
- Kom igångAPI-nyckel, första anropet och grundbegreppen. (öppnas i nytt fönster)
- Arbeta med REST-API:etStarta samtal, hantera fel och hämta resultat. (öppnas i nytt fönster)
- WebhooksSynkrona och asynkrona händelser, signering och omförsök. (öppnas i nytt fönster)
- Utgående från början till slutFrån API-anrop till färdig CRM-post. (öppnas i nytt fönster)
- Inkommande från början till slutKänn igen den som ringer och styr nästa steg. (öppnas i nytt fönster)
- Telefoni och nummerKoppla in egna nummer via SIP eller Twilio. (öppnas i nytt fönster)
- Schemalagda samtalRing vid en viss tidpunkt och avbryt vid behov. (öppnas i nytt fönster)
- Koppla in AI-agenter (MCP)OAuth, behörigheter och uppsättning i klienten. (öppnas i nytt fönster)
- REST-API-referensAlla endpoints, fält och svar. (öppnas i nytt fönster)
- Webhook-referensAlla händelser och vad de innehåller. (öppnas i nytt fönster)
- MCP-referensAlla verktyg och vad de gör. (öppnas i nytt fönster)
- Gränser och felRate limits, felkoder och hur du hanterar dem. (öppnas i nytt fönster)
Behöver du hjälp med integrationen?
Boka ett möte så går vi igenom uppsättningen tillsammans – eller ställ en snabb fråga i chatten.
Frågor från utvecklare
Hittar du inte svaret här? Fråga oss i chatten.
Du skapar API-nycklar i plattformen under Inställningar → Utvecklare. Nyckeln skickas i headern x-api-key i varje anrop.
Nej. Du lägger till MCP-servern som en connector i AI-assistenten och loggar in. Åtkomsten godkänner du själv, och du kan återkalla den när du vill.
Varje anrop har headern X-Threll-Signature, en HMAC-SHA256 av det råa innehållet signerad med hemligheten för ditt abonnemang. Verifiera den innan du läser innehållet.
Då definierar du egna verktyg och svarar på dem från din webhook-endpoint. Agenten kan då läsa från och skriva till vilket system som helst som du har ett API mot. Vill du ha hjälp, boka ett möte med oss.