# Elvo

> Elvo is an AI-first customer service platform. Conversations arrive from email, chat, and other channels; AI drafts and auto-replies handle most of the load with human agents supervising.

## Products

Elvo is a unified customer-service platform (þjónustuborð / helpdesk) for Icelandic businesses. One AI service agent — "Elvo-þjónninn" — answers across every channel, resolving simple requests automatically or drafting replies a human approves. Everything lands in one shared helpdesk where the team takes over with full context.

- Spjallþjónn (web chat) — answers website visitors instantly from your own content and hands complex cases to the team. https://elvo.is/spjallthjonn
- Svarþjónn (email & messages) — reads email, social messages, and web-form submissions, triages them, and writes reply drafts you approve. https://elvo.is/svarthjonn
- Raddþjónn (voice) — answers phone calls in Icelandic, resolves simple requests, transfers to a person during opening hours, and otherwise takes a message. https://elvo.is/raddthjonn
- Þjónustuborð (helpdesk) — the shared inbox that unifies every channel, enriched with AI and integrations. https://elvo.is/thjonustubord

## Pricing

Per-seat monthly plans, billed in ISK (+VAT). Four tiers: Lítill, Vöxtur (recommended), Stór, and Sérsniðið (custom pricing for larger organizations). The Raddþjónn voice agent is a paid add-on. Current prices: https://elvo.is/verdskra

## Company

Elvo is an Icelandic company serving Icelandic businesses; the product and its AI agents operate in Icelandic. Security and privacy: GDPR-compliant with a data-processing agreement, all data hosted within Europe (EU), AES-256 encryption in transit and at rest, and full audit trails.

- Home: https://elvo.is/
- Pricing: https://elvo.is/verdskra
- Web chat agent (Spjallþjónn): https://elvo.is/spjallthjonn
- Email agent (Svarþjónn): https://elvo.is/svarthjonn
- Voice agent (Raddþjónn): https://elvo.is/raddthjonn
- Helpdesk (Þjónustuborð): https://elvo.is/thjonustubord
- About us: https://elvo.is/um-okkur

## Public REST API

Elvo exposes a public REST API for AI agents and integrations. Authenticate with a Bearer token (format `elvo_...`) created from the organization settings. Read tokens can only make GET/HEAD requests; write tokens can also POST, PATCH, and DELETE.

- OpenAPI spec: https://elvo.is/api/public/v1/openapi.json
- Interactive docs: https://elvo.is/docs
- Base URL: https://elvo.is/api/public/v1

## Endpoints (v1)

All endpoints return JSON with envelope `{ "data": ... }` for single resources or `{ "data": [...], "pagination": { "next_cursor", "has_more" } }` for lists. Cursor pagination: `?cursor=...&limit=25` (max 100).

- POST /conversations — Create a conversation.
- GET /conversations — List conversations. Query: status, assigned_to_id, team_id, contact_id, tag, q, snoozed.
- POST /conversations/drafts — Create an outbound compose draft.
- GET /conversations/{conversationId} — Get a conversation.
- PATCH /conversations/{conversationId} — Update a conversation.
- POST /conversations/{conversationId}/snooze — Snooze a conversation.
- DELETE /conversations/{conversationId}/snooze — Unsnooze a conversation.
- GET /conversations/{conversationId}/comments — List conversation comments. Query: include_internal.
- POST /conversations/{conversationId}/comments — Send a reply or add an internal note.
- GET /conversations/{conversationId}/draft — Get the conversation draft.
- PUT /conversations/{conversationId}/draft — Create or update the conversation draft.
- DELETE /conversations/{conversationId}/draft — Delete the conversation draft.
- GET /chats — List your chats.
- GET /chats/{chatId} — Get a chat.
- GET /chats/{chatId}/messages — List chat messages.
- POST /chats/{chatId}/messages — Post a chat message.
- PATCH /chats/{chatId}/messages/{messageId} — Edit a chat message.
- DELETE /chats/{chatId}/messages/{messageId} — Delete a chat message.
- GET /contacts — List contacts. Query: q, email.
- GET /contacts/{contactId} — Get a contact.
- GET /users — List team members.
- GET /users/{userId} — Get a team member.
- GET /organization — Get current organization.
- POST /attachments — Upload an attachment.
- GET /webhooks — List webhook endpoints.
- POST /webhooks — Create a webhook endpoint.
- GET /webhooks/{webhookId} — Get a webhook endpoint.
- PATCH /webhooks/{webhookId} — Update a webhook endpoint.
- DELETE /webhooks/{webhookId} — Delete a webhook endpoint.

## Errors

```json
{ "error": { "type": "validation_error", "message": "...", "details": ... } }
```

Types: authentication_error (401), authorization_error (403), validation_error (400), not_found (404), rate_limit_exceeded (429), conflict (409), internal_error (500).

## Rate limits

200 read requests/minute and 60 write requests/minute per token. Standard headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `Retry-After`.

## Mentions

Notify a teammate from a note or chat message by writing `@[Name]` (their exact display name; matching is case-insensitive and whitespace-tolerant) in the content. Notes also support `@[team:Name]` and `@[everyone]` (admin tokens only). Unmatched names notify no one.

## Tags

Conversations carry `tags` — an array of tag names from an org-wide vocabulary (each tag also has a color and emoji, managed in the dashboard). Names are case-sensitive and max 100 characters. Writing `tags` on PATCH replaces the full list (empty array clears); unknown names create new tags automatically. Filter with `GET /conversations?tag=<name>` (exact name match).

## Not yet in the API

Bulk operations and composer features (scheduled send, forwarding). Email elvo@elvo.is if you need one of these.

## Custom integrations & chat widget

Beyond the REST API, Elvo pulls live context from a business's own systems into agent sidebars and AI reply drafts. Built-in connectors: DK, Business Central, Payday, Regla, Shopify, WooCommerce, HubSpot, Dropp, Abler. A custom integration covers any other system via a single HTTPS endpoint the business hosts — Elvo POSTs the contact's identity and latest message, the endpoint returns structured JSON (sidebar fields + an AI summary). Full contract with sample servers: https://elvo.is/docs (section "Custom integrations").

The customer-facing chat widget (Spjallþjónn) embeds on any website with a script snippet from Settings; widget conversations arrive in the workspace like any other channel and are readable via the REST API and webhooks. Embed snippet: https://elvo.is/docs (section "Embedding the chat widget").

## Help center (Icelandic)

- [AI-aðgerðir](https://elvo.is/hjalp/ai-adgerdir)
- [Vefþjónusta (API)](https://elvo.is/hjalp/api)
- [Áskrift og verðskrá](https://elvo.is/hjalp/askrift)
- [Flýtilyklar](https://elvo.is/hjalp/flytilyklar)
- [Flytja inn gögn](https://elvo.is/hjalp/flytja-inn-gogn)
- [Frammistaða](https://elvo.is/hjalp/frammistada)
- [Fyrirtækisstillingar](https://elvo.is/hjalp/fyrirtaeki)
- [Fyrstu skref](https://elvo.is/hjalp/fyrstu-skref)
- [Gervigreind — AI-drög og þekkingargrunnur](https://elvo.is/hjalp/gervigreind)
- [Hvað er Elvo?](https://elvo.is/hjalp/hvad-er-elvo)
- [Setja í bið og fresta](https://elvo.is/hjalp/i-bid)
- [Yfirlit](https://elvo.is/hjalp)
- [Leit og geymsla](https://elvo.is/hjalp/leit-og-geymsla)
- [Merki](https://elvo.is/hjalp/merki)
- [Meta (Facebook og Instagram)](https://elvo.is/hjalp/meta)
- [Notendur og hlutverk](https://elvo.is/hjalp/notendur)
- [Persónulegar stillingar](https://elvo.is/hjalp/personulegar-stillingar)
- [Reglur](https://elvo.is/hjalp/reglur)
- [Sameina mál](https://elvo.is/hjalp/sameina-mal)
- [Samþættingar](https://elvo.is/hjalp/samthaettingar)
- [Setja upp spjallþjóninn](https://elvo.is/hjalp/spjallthjonn)
- [Stöðluð svör](https://elvo.is/hjalp/stodlud-svor)
- [Svara viðskiptavinum](https://elvo.is/hjalp/svara-vidskiptavinum)
- [Svarglugginn](https://elvo.is/hjalp/svargluggi)
- [Tengiliðir](https://elvo.is/hjalp/tengilidir)
- [Teymi og samvinna](https://elvo.is/hjalp/teymi)
- [Tilkynningar](https://elvo.is/hjalp/tilkynningar)
- [Undirskriftir](https://elvo.is/hjalp/undirskriftir)
- [Viðmótið](https://elvo.is/hjalp/vidmotid)
- [Að vinna með mál](https://elvo.is/hjalp/vinna-med-mal)
- [Áframsending](https://elvo.is/hjalp/tengja-tolvupost/aframsending)
- [Gmail / Google Workspace](https://elvo.is/hjalp/tengja-tolvupost/gmail)
- [Tengja tölvupóst](https://elvo.is/hjalp/tengja-tolvupost)
- [Outlook / Microsoft 365](https://elvo.is/hjalp/tengja-tolvupost/outlook)

## Help center (English)

- [AI actions](https://elvo.is/help/ai-actions)
- [AI drafts & knowledge base](https://elvo.is/help/ai-drafts-and-knowledge)
- [Public API](https://elvo.is/help/api)
- [Automation rules](https://elvo.is/help/automation-rules)
- [Billing & plans](https://elvo.is/help/billing)
- [Canned responses](https://elvo.is/help/canned-responses)
- [Set up the chat agent](https://elvo.is/help/chat-agent)
- [The composer](https://elvo.is/help/composer)
- [Contacts](https://elvo.is/help/contacts)
- [Import data](https://elvo.is/help/import-data)
- [Overview](https://elvo.is/help)
- [Integrations](https://elvo.is/help/integrations)
- [Keyboard shortcuts](https://elvo.is/help/keyboard-shortcuts)
- [Merging tickets](https://elvo.is/help/merging-tickets)
- [Meta (Facebook & Instagram)](https://elvo.is/help/meta)
- [Notifications](https://elvo.is/help/notifications)
- [Organization settings](https://elvo.is/help/organization)
- [Performance](https://elvo.is/help/performance)
- [Personal settings](https://elvo.is/help/personal-settings)
- [Quickstart](https://elvo.is/help/quickstart)
- [Replying to customers](https://elvo.is/help/replying-to-customers)
- [Search & archive](https://elvo.is/help/search-and-archive)
- [Signatures](https://elvo.is/help/signatures)
- [Snoozing & on hold](https://elvo.is/help/snoozing)
- [Tags](https://elvo.is/help/tags)
- [Teams & collaboration](https://elvo.is/help/teams)
- [The interface](https://elvo.is/help/the-interface)
- [Users & roles](https://elvo.is/help/users-and-roles)
- [What is Elvo?](https://elvo.is/help/what-is-elvo)
- [Working with tickets](https://elvo.is/help/working-with-tickets)
- [Forwarding](https://elvo.is/help/connect-email/forwarding)
- [Gmail / Google Workspace](https://elvo.is/help/connect-email/gmail)
- [Connect email](https://elvo.is/help/connect-email)
- [Outlook / Microsoft 365](https://elvo.is/help/connect-email/outlook)