Aller au contenu

// integration

What applies to every connector

Applies to

Product: Cloud · Server · Audience: Administrator

The connector pages describe what each connector does, which settings and sign-in it needs and which tools it provides. This page covers what is the same for all of them.

basebox must reach the other system

A connector that talks to another system, such as a wiki, a mail server or a ticket system, reaches it over the network from where basebox runs. The address is set in the connector's settings. On basebox Server the Platform Operator can also set it via Helm (Connector configuration); a value in the connector's settings takes precedence.

Changes to the settings apply without a restart

basebox reads a connector's settings each time it prepares the assistant's tools for a chat. A changed address, sign-in mode or public web address applies to the next answer; basebox does not need to be restarted.

Every link in the assistant's answers opens in a new browser tab, so the chat stays open. Links that point to a connected system also carry an icon showing that they leave basebox.

Some connectors have the field Public web address in their settings. basebox adds its text unchanged to the assistant's instructions for that connector. Describe there where the system is published and what a link to one of its pages looks like, for example:

This wiki is published at https://wiki.example.org/dokuwiki. Build page links as https://wiki.example.org/dokuwiki/doku.php?id= and suggest opening them in a new tab.

The field appears when the connector brings its own link hint, which basebox enters as the field's first value, or when the field already holds a text. Of the connectors on these pages, only SharePoint brings a link hint. Without this text the assistant has only the addresses the connector returns, which can be internal or incomplete.

Fewer tools give better answers

The assistant chooses from all tools of all connectors that are switched on for an app. The more tools it has to choose from, the more often it picks an unsuitable one. Switch a connector on only in the apps whose users need it.

Further reading