telkit
Kom i gang

For utviklere

Endringslogg

Det som er nytt og endret i telkits API, nyeste først. Hvordan du bruker det, står i utviklerdokumentasjonen.

Mediestrømmer og boter

Koble din egen taleassistent til en samtale, enten som en strøm av lyd eller som en deltaker i rommet.

Mediestrømmer

  • Strøm lyden fra en samtale til en WebSocket på serveren din, i meldingsformatet til Twilio Media Streams (POST /v1/calls/:id/streams, eller stream på POST /v1/calls).
  • Les og stopp en strøm (GET /v1/calls/:id/streams/:streamId, POST /v1/calls/:id/streams/:streamId/stop).

Boter

  • Din egen bot som deltaker i samtalen, med sin egen nøkkel til rommet (POST /v1/calls/:id/participants med kind bot).
  • Mediestrømmer og boter er ikke åpnet for salg ennå. Til da svarer API-et capability_unavailable.

API v1

Den første versjonen av telkits REST-API under /v1, med hendelser som webhooks, logg og strøm.

SMS

  • Send SMS nå eller på et tidspunkt, avbryt en planlagt SMS og regn ut pris før du sender (POST /v1/sms, /v1/sms/quote, /v1/sms/:id/cancel).
  • Tre avsendere: godkjent avsendernavn, felles svarnummer og profilens eget nummer.
  • Avmelding med STOPP og påmelding med START, avmeldingslisten over API-et (/v1/sms-opt-outs) og hendelsene sms.optedOut og sms.optedIn.
  • Kontakter, kontaktgrupper og SMS-kampanjer til en gruppe eller en liste (/v1/contacts, /v1/contact-groups, /v1/campaigns).

E-post og brev

  • E-post fra ditt eget domene med godkjente avsendere (POST /v1/email).
  • Brev digitalt i Digipost eller på papir i posten (POST /v1/letters).

E-postkampanjer

  • E-postkampanjer til en kontaktgruppe eller en liste, med pris på forhånd og avbryt (/v1/email-campaigns, /v1/email-campaigns/quote).
  • Hver kampanje-e-post har en avmeldingslenke og avmelding med ett klikk (List-Unsubscribe).
  • Avmeldingslisten for e-post over API-et (/v1/email-opt-outs).

Samtaler

  • POST /v1/calls med telefon og app-brukere i samme samtale, konferanser og samtaler mellom app-brukere uten telefon.
  • Legg til, demp, sett på vent og ta ut deltakere mens samtalen pågår.
  • Les opp tekst, spill lyd og spør innringeren med tastetrykk eller tale.
  • Innkommende samtaler med hendelsen call.incoming og en frist: svar, avvis, flytt, sett over eller la flere ringe samtidig.
  • Opptak og tekst etter samtalen over API-et (/v1/recordings, /v1/transcripts).
  • Tekst mens samtalen pågår, som en strøm av server-sent events.
  • Gjetting av telefonsvarer, med valg om å legge på eller legge igjen en beskjed.

Numre

  • Finn ledige numre, bestill, endre og si opp over API-et (/v1/numbers), med din egen selgerreferanse (assignedTo) og egne etiketter.
  • Slå opp et nummer: hva slags nummer det er, og hva det koster å ringe (GET /v1/lookup).

Tale til tekst

  • Lydfiler til tekst som JSON, SRT, VTT eller ren tekst (/v1/transcription/jobs).
  • Direkte lyd over WebSocket med linjer tilbake med en gang (/v1/transcription/sessions).

AI-agenter og sammendrag

  • AI-agenter med egen instruks og verktøy, eller med svar fra ditt eget webhook-endepunkt (/v1/agents).
  • Sett en agent inn i en samtale som deltaker (POST /v1/calls/:id/participants), med hendelsen call.agent.ended når den går ut.
  • Sammendrag av en samtale eller en transkripsjonsjobb (/v1/calls/:id/summary, /v1/transcription/jobs/:id/summary) og hendelsen call.summary.ready.
  • Agenter og sammendrag er ikke åpnet for salg ennå. Til da svarer API-et capability_unavailable og summary_unavailable.

Hendelser

  • 39 hendelser, hver med én offentlig id (evt_…) i loggen, i strømmen og i hver webhook.
  • Hendelsesloggen etter posisjon (GET /v1/events) og hendelsesstrømmen (GET /v1/event-stream).
  • Webhook-endepunkter over API-et: test, bytt hemmelighet, Ed25519, leveringsforsøk og nye forsøk av leveringer som ga opp.

Nøkler, bruk og grenser

  • Tilganger per API-nøkkel, nøkler for én profil, og nøkler og profiler over API-et.
  • Forbruk per dag og tjeneste (GET /v1/usage) og månedsoppgave som CSV (GET /v1/statements).
  • Daglige grenser for bedriften (GET /v1/limits) med hendelsen limit.reached, og balance.low når saldoen blir lav.
  • Pris på forhånd for en samtale, en SMS-tekst eller opplest tekst (POST /v1/prices/preview).

Kom i gang med telkit

Registrer bedriften med organisasjonsnummeret.

Kom i gangSe prisene