For administrators
← All topics

Integrations

Connecting the organisation to a CRM (HubSpot, Raynet) and which mailboxes may read from it.

Organisation → Integrations holds the connections to external systems — CRMs and helpdesks the assistants may read from. App registrations for mail access are in the Sign-in and mail access section (see Mail access: the options).

What a connection is for

A connection lets the assistant know who is writing: what company, who looks after it, what deals or open tickets it has. draften works with HubSpot, Raynet CRM and FLOWii today.

What holds for every connection:

Data from a connection, like the e-mail itself, goes to the language model provider.

Adding a connection

Choose the system, fill in a title and the access secret (and for Raynet and FLOWii more fields). The secret is entered once, stored encrypted and never shown again. Then click Test the connection: the test finds out whose account it is, which parts the secret opens, and warns when the secret could also write.

SystemAccess secretStep by step
HubSpota service key (Settings → Integrations → Service Keys), or the token of an older private app (starts with pat-), with read scopes only: contacts, companies, owners, deals, ticketsHubSpot
Raynet CRMthe server, the instance name, the login e-mail and the API key of a read-only userRaynet CRM
FLOWiithe login e-mail and password of a user with the narrowest rights, and the API key; for a login reaching several companies, the company ID tooFLOWii

Granting to mailboxes

What a connection returns may show up in drafts — and drafts are read by everyone with access to the mailbox. That is why no mailbox uses a connection until you grant it:

Without a grant, the mailbox's editors do not even know the connection exists.

Granting to every new mailbox

Below the Which mailboxes may use the connection list, the organisation's connection has a Grant to every new mailbox checkbox:

A connection a mailbox owner connected only for their own mailbox has no such checkbox.

A mailbox's own connection

A mailbox owner may connect a system of their own, for their mailbox alone. Nobody approves it; the organisation's owners and managers get an e-mail and may switch it off or remove it. For users it is described in Connecting a CRM and other systems.

Plain text version