Utvikler-API
Koble et annet system til Voximate
Dette er innkommende partnerintegrasjon — ikke Slack- eller Gmail-Connect. Andre tjenester kaller gatewayen direkte.
Base URL
https://api.voximate.no
Ikke voximate.no (markedsføring) og ikke dashboard-BFF /api/….
Autentisering
Alle beskyttede ruter krever Authorization: Bearer <token>. I dag godtar gatewayen en bruker-JWT fra login. API-nøkler (vox_live_…) lages under Innstillinger — det er den tiltenkte maskin-hemmeligheten; gatewayen tar dem neste.
curl -sS https://api.voximate.no/auth/v1/login \
-H 'Content-Type: application/json' \
-d '{"email":"you@company.com","password":"…"}'
curl -sS https://api.voximate.no/agents \
-H "Authorization: Bearer $ACCESS_TOKEN"Ruter (som faktisk finnes)
| Method | Path | Auth | Merknad |
|---|---|---|---|
| GET | /health | — | Gateway liveness |
| POST | /auth/v1/login | — | Email + password → JWT |
| GET | /agents | Bearer | List agents (?page&limit) |
| GET | /agents/{id} | Bearer | One agent |
| POST | /agents | Bearer | Create agent |
| GET | /analytics/calls | Bearer | List stored calls |
| GET | /analytics/calls/{id} | Bearer | Call detail |
| POST | /v1/calls | Bearer | Outbound call (agent_id, to_number) |
| GET | /phone-numbers | Bearer | DIDs |
| GET | /v1/knowledge-bases | Bearer | Knowledge bases |
| GET | /v1/tools | Bearer | Registered tools |
| POST | /sms-workflows/hooks/{tenantId}/{workflowId}/runs | — | Google review agent: job finished → SMS (workflow key, see below) |
| GET | /sms-workflows/review-insights | Bearer | Google links sent + customer feedback |
Utgående samtale
curl -sS https://api.voximate.no/v1/calls \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"agent_id":"<uuid>","to_number":"+4722405104"}'Google-anmeldelser: koble kalender, CRM eller booking-system
Ett kall når en jobb er ferdig. Kunden får SMS fra Voximate-nummeret ditt og blir spurt om 1–5; 4–5 får Google-lenken med en gang; 1–3 får beklagelse og spørsmål, du varsles, og lenken kommer 2 døgn senere. Google Kalender, Calendly og Cal.com er innebygd — alt annet bruker dette endepunktet med nøkkelen fra SMS → Google-anmeldelser.
curl -X POST https://api.voximate.no/sms-workflows/hooks/{tenantId}/{workflowId}/runs \
-H 'Authorization: Bearer whsec_…' \
-H 'Content-Type: application/json' \
-d '{"counterparty":"+4791234567","idempotencyKey":"job-8821","variables":{"name":"Kari","service":"Nettside"}}'Svar: 202 startet · 200 duplicate (samme idempotencyKey, ingenting sendt) · 401 feil nøkkel · 409 ikke aktivert.