Integrations (InstaCRM and plugins)

Tenant admins open Admin → Integrations (/admin/integrations). This is a bolt-on so another app (InstaCRM) can screen-pop and click-to-dial. Octone does not become a CRM.

API key

1. Click Generate API key (or Rotate).
2. Copy the key once. It starts with oct_ and is not shown again.
3. Your app sends Authorization: Bearer oct_… on every plugin request.

Webhook (screen-pop)

Save a Webhook URL. Octone POSTs, fire-and-forget, on:

• call.started
• call.answered
• call.ended
• sms.received

Optional signing secret (shown once). When set, Octone sends:

Call payload

json { "event": "call.started", "id": "evt_…", "createdAt": "2026-08-24T15:00:00.000Z", "tenantId": "…", "data": { "callId": "…", "direction": "inbound", "from": "+13125550100", "to": "+13125550199", "status": "initiated", "startedAt": "…", "answeredAt": null, "endedAt": null, "durationSec": null, "extension": { "id": "…", "ext": "101", "label": "Front desk" } } }

call.answered / call.ended use the same data shape with later timestamps and status (answered, completed, missed, …).

SMS payload

json { "event": "sms.received", "data": { "messageId": "…", "from": "+1…", "to": "+1…", "body": "Hello", "createdAt": "…" } }

REST

All three require the Bearer key.

• GET /api/plugins/me — { tenant: { id, name, slug } }
• GET /api/plugins/calls?limit=50 — recent call log rows (id, direction, from, to, status, times, extension). Optional direction=inbound or outbound.
• GET /api/plugins/lookup?number= — resolve recent calls and SMS for a number (CRM screen-pop).
• POST /api/plugins/calls/:id/disposition — set a hangup disposition code (answered, voicemail, callback, sale, not_interested, wrong_number, other). Agents can also POST /api/calls/:id/disposition from the softphone.
• POST /api/plugins/dial — click-to-dial as a person:

json { "to": "+13125551212", "userId": "…" }

or { "to": "+13125551212", "extension": "101" }. Octone rings that person's desk (or cell if they are out of office), then connects the destination. The company DID is the caller ID.

No carrier brand or portal is required for this integration.