Connected actions: live answers from your other apps
Let an app you use give your Secretary live answers from its own data, or make a change for a customer once they confirm. Test each action, switch it on or off, and see every call.
Some answers live in another app: today's stock in your warehouse system, a price in your quoting tool, figures in a database you run. A connected action lets your Secretary look them up while it chats, then answer from what comes back.
An app can also add an action that makes a change in that app for a customer, such as opening a support ticket or saving a callback request. It runs only after the customer says yes to what will be sent.
- Give the app a keyIntegration, API keys.
- The app adds actionsThey arrive switched off.
- Test each oneWith real values.
- Switch it onLive on every text channel.
Connecting an app
- Open Integration, then API keys, and create a key named after the app. Give it to the app's team, or paste it into the app's settings.
- The app registers its actions, and can also push text your Secretary answers from, like FAQs.
- Open Integration, then Connected actions. Each action arrives switched off.
Developers building the app: see the developer guide to connected actions.
Testing and switching on
For each action, read what it says it does, then press Test. Fill in the details a customer would give and send it: you see exactly what your Secretary would read. When the answer looks right, press Switch on.
For an action that makes a change, the button says Test (no change is made). The app is sent a call marked as a test, with no customer details, and must treat it as a dry run. Switch on then asks once more: it names the app, what it says it does, where the request goes, and which of the customer's contact details it receives.
From then on, when a customer asks something the action covers, your Secretary calls it and answers from it, on your chat page, website widget, WhatsApp, Telegram, Instagram, Messenger, email and phone calls. An action switched on during a call is used from the next call. Actions that make a change work on every text channel, not on phone calls yet.
What an action can and cannot do
Each card says what the action does: Looks things up, or Makes a change: asks the customer to confirm first.
- A lookup cannot book, charge, cancel or change anything. Your Secretary quotes what it returned and never invents a figure. If the app is down or slow, it tells the customer it could not check just now.
- An action that makes a change runs only after the customer says yes to what will be sent, every time. It changes things in the app only: bookings, orders and payments on Ordina never go through an action.
- If the app does not confirm a change in time, your Secretary tells the customer it could not confirm it and that the team will check, and you are told.
- For a lookup, the app receives only what the customer asked for that question, your business handle and a conversation id, never their name, email or phone. Ordina refuses an action that asks for them as part of its request.
- An action that makes a change receives only the contact details its card lists, which you approve when you switch it on. The card also says how sure they must be: only when your Secretary has proof, such as their WhatsApp number, or as the customer types it.
Staying in control
- Switch off an action at any time; your Secretary stops calling it at once. Remove it to delete it and its history.
- Each action says which key or app added it.
- If the app changes an action in any way (what it says, what it asks for, the address it calls, what it does, or the contact details it receives), the action switches itself off. Its card lists what changed since you approved it, field by field; check it, then press Approve changes and switch on.
- Disconnect an app, or revoke its key, and every action and intake it added is switched off at once. The confirmation lists what stops.
- Recent calls under each action show what was asked, whether it answered, and how long it took. For an action that makes a change, they say whether it was done and which contact details went with it. After 3 failures in a row you see a warning.
Intakes: questions an app asks your customers
An app can also add an intake: a few questions your Secretary asks a customer for that app, such as the details for a quote or a callback request. When the customer has answered every required question, the answers go to the app. If your Secretary picked up an answer from something the customer said before that question was asked, it reads those answers back first, and nothing goes to the app until the customer has confirmed or corrected them.
- Intakes appear under Intakes on the same page, each switched off when it arrives.
- Each card lists every question, which app or key added it, and how many responses it has. See responses shows the answers your Secretary collected.
- Switch on first shows every question again, and names the contact details the app will receive, for example "This app will receive the customer's email and phone number." Switch it on only if you are happy for the app to have them.
- If the app changes the questions, the intake switches itself off and its card lists what changed, question by question. Check it, then press Approve changes and switch on.
- Switch off an intake at any time, and nothing more is sent to the app. Remove deletes the intake and the answers kept with it.
- Disconnecting the app, or revoking its key, switches its intakes off.
- Intakes work on your chat page, website widget, WhatsApp (on your own number), Telegram, Instagram, Messenger and email, not on phone calls yet.
Knowledge from connected apps
Text an app pushes appears under Knowledge from connected apps on the same page, with the app's or key's name, and with your other knowledge sources in your Secretary settings, under What I know, marked as added by that app. It counts toward your plan's knowledge sources: up to 5 on the Business plan, together with your PDFs and websites. Remove any of it there, or tick Also remove the knowledge it added when you disconnect the app or revoke its key.
Your Secretary never treats an app's text as your own Terms, privacy, refund or cancellation policy. Add those as documents yourself.
Plans
Connected actions and intakes are part of the Business plan. If your plan lapses or moves to Pro, your Secretary stops calling actions and asking intakes until Business is active again, and intakes cannot be switched on.
