How connectors work
A connector is a saved link to one outside system. Everything else in IntELIEKonnect follows from a few ideas, and they explain the two things that surprise people most: why a connector has two statuses, and why a working connector can still move nothing.
One connector, one direction, one system
A connector is either an import connector or an export connector, and it lives on Import Connectors or Export Connectors accordingly. Its type, the system it talks to, is fixed when you create it. Two mailboxes are two connectors. One mailbox feeding two orchestrators is still one connector: what happens to a document is decided by whatever the connector is bound to.
Two statuses that move separately
| Status | The question it answers |
|---|---|
| Connector Status | Where is it in its life: a draft, set up, switched on, switched off? |
| Engagement Status | Did the last sign-in or connection test work? |
A connector can be Initialised and Connected: tested, but not switched on, so it fetches nothing. It can be Disabled and Authentication Failed: Elie switched it off because its password stopped working. The lists shorten Connector Status to Active or Inactive; the connector's own Overview tab shows the full value. See Connector statuses explained.
Four things before anything moves
- It is connected: its sign-in has been tested and worked. Enable stays hidden until then.
- It has a schedule, if it is an import connector. Elie refuses to enable an import connector without one.
- It is enabled. Only an Active connector runs, and only an Active one is offered when you bind.
- It is bound. A binding connects the connector to something that uses it: an IntELIEDocs orchestrator's Import Channels or Export Channels, a knowledge base's sources, or a Voice IntELIEgence app. You make it in that module, not here.
An import connector with no binding doesn't run. Once you bind it, its next run collects everything that has arrived since you enabled it, so nothing is lost by binding late. Its first run picks up only what arrives after you enable it, unless you turned on the option to import existing files, emails or records.
Exports go out at once or in batches
An export connector delivers each document as soon as it finishes processing, or collects them and delivers one batch on a schedule. You choose under Group Export on its Schedule Configs tab: Immediate Delivery or Scheduled Batch. A Webhook connector and the accounting exports always deliver at once. If a result seems late, check the connector's schedule before assuming processing failed.
When a sign-in stops working
If a password is changed, a key is revoked or a provider sign-in expires, Elie switches the connector off itself: Disabled, with Authentication Failed or Not Connected. Its Configuration tab then shows Action required with the fix, and it appears under Required Attention on Home. Fixing the sign-in doesn't switch it back on; select Enable when you are ready.
When one file can't be imported
An import connector brings items in order, so one bad file could hold up everything behind it. When a file can never be imported, because it is empty, too large or gone, Elie sets it aside and carries on, and the connector lists it until you dismiss it. See Handling skipped files.
Next
- Connector statuses explained - every status and what to do about it.
- Choosing a connector type - what you can connect to.
- Finding and creating import connectors - the first thing to do.