Manual

Connecting your accounts: Google, Microsoft 365, email and tools

Once a channel is connected, Orion already talks to you. This chapter is about what it can reach: you link Google or Microsoft 365 — calendar, email and documents —, forward your email so it reads what comes in, connect third-party tools, and let the assistant you already use (Claude, ChatGPT or Grok) look up what Orion knows.

Read in: Portuguese · Spanish · French

Where it talks to you — WhatsApp, Telegram or voice — and the channels where it serves your public are in the chapter Connecting Orion.

Google and Microsoft 365

Connecting one of these two accounts is what most increases what Orion can do. You can connect both, one, or neither — nothing here is required.

The connection finishes in the same browser where it started — or, for your Google account, in your chat with Orion. Every account connection — Google, Microsoft 365, the prospecting sending mailbox, Instagram and the integrations that connect through the service's page — can start at the dashboard button, signed in, and then only finishes in that same browser, within 15 minutes; each one works only once. Your Google account can also be connected through the chat, with one tap (see Google, below): the account that comes back is only used after your YES there. An authorization link passed on to someone else connects nothing without you. If the account that comes back is not the one already linked, nothing is changed — to switch, disconnect the current one and connect the new one; for an integration, this holds when the service says which account came back (see Some integrations connect through the service's own screen, below). If, between the click and the return, the Orion account that started the connection is deactivated or removed from the organization, the connection does not finish and nothing is linked. And many connection attempts from the dashboard coming from the same network in a short time pause new connections from that network for a few minutes — at most an hour; the page that opens says how long to wait. In the app, the button opens the same page in the device's browser, already signed in.

Google

Open Orion → Google in the dashboard and click "Connect Google". Authorize on the Google screen and the page refreshes on its own. Through the chat, in your WhatsApp or Telegram chat with Orion (never in a group), ask "connect my Google" — or follow step 3/4 of the setup (in Connecting Orion): Orion sends a link that goes straight to Google; it works for 15 minutes and only once, and only the last one it sent works. Once you authorize, the browser shows "Almost there — confirm in your chat with Orion", and Orion asks you there: "I connected the Google account [email protected]. Is it your account?". Reply YES for it to start using it, or NO to undo; until then, nothing from the account is used. Only a whole answer counts — yes or no, also in Portuguese or Spanish —, and only yours, in that chat; if Orion has said something else since the question, reply YES GOOGLE or NO GOOGLE. With no answer within 24 hours, it undoes it on its own. If the link ends up with someone else and they sign in with their own account, the question shows their email: reply NO. Renewing with the same account already linked asks nothing; a different account, with one already linked, is refused.

What it can doExample request
See, create, edit and cancel events in Calendar"How does my calendar look tomorrow?" · "Book a meeting with Ana on Tuesday at 3pm"
Send email through Gmail on your behalf"Reply to this email saying we're set for Friday"
Create and edit documents and spreadsheets in Drive"Put together a spreadsheet with these numbers"
Look up your Contacts (read-only)"What's the email of Ricardo from Acme?"

Four limits worth making clear from the start, because they explain almost every "why couldn't it do it?":

It does not read your Gmail inbox. The permission requested is send, not read. For Orion to read what arrives, use the email forwarding described below.

In Drive, it only sees what it created itself. That is the minimum scope (drive.file). If you ask "list my Drive files", only the files Orion created come back — your older documents it does not see, does not open and does not edit. When it tries, that is exactly what it answers.

It does not grant access to anyone. When it creates a document or spreadsheet, Orion gives you back the link; sharing it with someone else is up to you. (In OneDrive, on the Microsoft side, it can generate a sharing link — the asymmetry is real.)

It reads every checked calendar, and says how far it was read. It reads the main calendar of the connected Google account and every calendar checked in that account's Google Calendar list — its own and the ones other people shared with it —, up to 15; if there are more, it says how many were left unread. Left out, on purpose, are only Google's automatic holiday and birthday calendars: that is why it does not use the calendar to say whether a day is a holiday or someone's birthday. To make Orion stop reading a calendar, uncheck it in the connected account's Google Calendar. The same event on two calendars (an invitation that is on yours and on the connected account's, for example) shows up only once. The conversation and the morning and end-of-day briefs read the same calendars. When a calendar has more events in the requested window than it brought back, it says how many it read and that there are more, and it does not claim a time is free after the last event it read.

It checks the calendar on the spot. When you ask for your calendar, it reads it again instead of repeating an old read from the conversation. And there is a safety net: when the system notices a list of events it did not check, it reminds it to check before answering.

The page itself sums up the permissions requested: your email address, Calendar, Gmail send, Drive files it creates, and read-only Contacts.

Microsoft 365

If your company lives in Outlook and Teams, this is your chapter. Open Orion → Microsoft 365 and click "Connect Microsoft 365". A Microsoft window opens; after you authorize, close it — the page refreshes on its own.

On most accounts this is one click and needs no IT admin. If your company has turned off per-user consent, the Microsoft screen will say "Approval required". In that case, click "Generate admin link" on the same page: the link comes already copied, you send it to IT, and their approval unblocks the whole organization at once. The link only grants that approval: completing it does not link the account of whoever opened it to your Orion account. After the approval, each person connects their own account from the dashboard.

What it can doExample request
Read and triage the Outlook inbox (the most recent messages)"Anything important in my email?"
Send and draft email in Outlook"Reply to Ricardo saying we're set for Friday" · "Leave a draft for me to review"
See, create, edit and cancel events in Calendar"Book a meeting with Ana on Tuesday at 3pm" · "Cancel Thursday's and tell the guests"
Read and send messages in Teams — 1:1 and group"What happened in the project chat today?" · "Tell the team on Teams that the release is out"
Create and update spreadsheets in Excel, create documents in Word"Put together a spreadsheet with these numbers" · "Write the minutes of this meeting"
List, organize and share files in OneDrive"Create the Clients 2026 folder and send me the sharing link"
Create pages in OneNote and tasks in To Do"Note this down in OneNote" · "Add to To Do: call the accountant"

And the limits, which here are different from Google's:

It reads your Outlook inbox — directly, with no forwarding, but not all of it. Connecting Microsoft 365 grants email read access. It is more power and it is also less privacy than the Google side; the choice is yours, and disconnecting is one button on the same page. What it reads each time: only the Inbox folder, the most recent messages — up to 25 — and, for each one, the sender, the subject, the time and the beginning of the text. Other folders (junk, archive, subfolders) and older messages are left out, and in Outlook it has no search by sender or subject. So when it answers, it says how much it read and what was left out, and it does not treat that part as the whole mailbox: if the email you are looking for did not show up there, that does not prove it never arrived.

Teams channel messages are not accessed. It reads and writes in 1:1 conversations and in group chats. Team channels (those tabs inside a team) would require an admin permission that the product deliberately does not request. Here too the read is partial, and it says so in its answer: the list brings up to the 20 conversations with the most recent activity, and in each conversation it reads up to the last 30 messages (very long ones, only the beginning).

Personal Microsoft accounts do not work. The connection is built for corporate/educational accounts (work or school).

If a new feature asks for permission, renew. The permissions for files, drafts, OneNote and To Do were added on July 28, 2026. Anyone who authorized before that keeps email, calendar and Teams working normally, but the new features will ask for the missing permission — use Renew permissions on the Microsoft 365 page, without disconnecting, and with the same account: a different account is refused and nothing is changed.

On Outlook, it reads every calendar in your list. The default one first, up to 15, and it looks up to 30 days ahead; the same event on two calendars shows up once. Microsoft 365 group calendars are still left out. To read the calendars other people shared with you, the connection asks for the shared-calendars permission: if you were already connected before this permission existed, or if Orion says a shared calendar went unread for lack of permission, use Renew permissions on the Microsoft 365 page (your current connection keeps working meanwhile; do not disconnect). If your company requires IT approval, first ask your admin to approve through the link on the same page. When Microsoft refuses a calendar, it says which one was left unread, instead of saying there is no meeting there. An event on a calendar someone else shared with you is shown, but it does not edit or cancel it — even when they gave you edit permission. When the calendar has more events in the requested window than it brought back, it says how many it read and that there are more, and it does not claim a time is free after the last event it read.

About sending things on your behalf

This is worth stating precisely, because it is a point where the promise and the behavior have to match.

When Orion is about to fire off a send to a third party (email, WhatsApp, Teams message, calendar invitation with external guests, a change to or cancellation of an event that already has an external guest), there is an automatic hold: the system holds the send, shows you a draft field by field — "Send confirmation — nothing has been sent yet" — and only sends after your yes. That draft is assembled by the system itself, not narrated by the model, and your yes is bound to that exact text: change one comma and you have to confirm again. For a change to or cancellation of an event, the system first checks who is on it: the card says who will be notified, and an event that is only yours goes through without a card; if it cannot check, it holds and asks. The card for a new event and the one for a change start with "Send confirmation"; the one for a cancellation, with "Action confirmation — nothing has been done yet".

This hold applies to every send of this kind, not only when the turn read external content first — an email, an attachment, a web page, a group message. In those cases it is also a defense against planted instructions: what it has just read may be exactly what is asking for the send.

It applies on a direct request from you, on a clean turn — "send an email to João saying we're set for Friday" —: it resolves the contact and shows you the draft before sending. And it applies in voice conversation: the draft is read aloud and the yes is spoken.

In practice, the habit that works: when you want to work on the wording before the card, split it into two requests. "Write the email to João about the proposal, but don't send it yet." You read it, adjust it, and only then: "go ahead and send it."

Forwarded email

This is the optional step that most changes the routine of anyone who lives in the inbox. It exists because Orion does not read your Gmail — the permission it asks for on Google is send. Forwarding is what gives it the other side.

  1. In the dashboard, open Orion → Emails and click Copy on the address field. It has the form [email protected].
  2. In your provider (Gmail, Outlook, iCloud, Yahoo…), set up auto-forwarding to that address.
  3. Gmail asks for 2 steps, and the second one is easy to miss. The first is to confirm: Gmail sends a confirmation request to Orion's address, one you would never see. If the mailbox that asked is one of your accounts (the connected Google or Microsoft account, the prospecting sending mailbox or your sign-up email), a mailbox that has forwarded to Orion in the last 6 months, or a mailbox on the same company domain as one of your accounts (another @yourcompany.com mailbox; never Gmail, Outlook and other free email), and the request really came from Google, Orion tries to confirm it on its own. Either way, it lets you know on your channel with it, saying which mailbox asked, and sends the same message by email to that mailbox, which is where you are at that moment. If it couldn't confirm, the message has the link and the code: open the link and confirm.
  4. After you confirm, forwarding is still off. That is the second step, and Gmail doesn't mention it: go back to Settings › See all settings › Forwarding and POP/IMAP, refresh the page, select "Forward a copy of incoming mail to" Orion's address and click Save Changes. Without it, nothing arrives. Both steps are done in Gmail on a computer.

Orion follows up until the first email arrives. When the first email forwarded by that mailbox arrives, it lets you know: "✅ Forwarding from … is working". If none arrives 2 hours after the request, it reminds you of the two steps, with the link again, and reminds you once more at 24 hours. These notices go out between 7 a.m. and 9 p.m. in your time zone. After 7 days with no email from that mailbox, it stops following up. If the mailbox that asked is none of these, Orion does not confirm: it lets you know once, says why and doesn't remind you. If it was you, the steps are the same; if it wasn't, ignore it. You get at most one request notice per mailbox per day. On official WhatsApp, outside the 24-hour window, the notice is short and goes without the link. The link is still in the email to the mailbox, when Orion recognizes it, and the request stays in Orion's email inbox: just ask Orion for it. If Orion can't confirm the request really came from Google, it neither confirms nor notifies you.

From then on, the question that unlocks everything is simple: "anything important in my email?". It summarizes what arrived, sorts out what matters, reads the whole email when you ask, opens attachments (PDF, image, Word, Excel, CSV, text) and drafts replies. The reply goes out through the account you connected — Gmail, if Google is connected; Outlook, if it is Microsoft.

The Emails page shows what it has already received, with the counters for New, Skimmed, Read and Total. The Your mailboxes card shows each mailbox that forwarded to it in the last 90 days or asked to forward, with its status: Forwarding (and the date of the last email), Not on yet (the request was confirmed; the second step is missing), Needs confirmation (Orion couldn't confirm it on its own) or Request from another mailbox (a mailbox it doesn't recognize). In the last three, the Open this mailbox's forwarding tab link goes straight to that mailbox's Gmail screen. The I haven't received any forwarded email yet notice at the top only goes away when a real forwarded email arrives: Gmail's confirmation request doesn't count.

Who wrote it, and through which mailbox. In a forwarded email, the sender Orion shows is whoever wrote it, not the mailbox that forwarded it, and Orion knows which of your mailboxes it came through. If the same email arrives twice, through two forwarded mailboxes or two routes, only one copy is kept.

When you ask "did Ricardo reply?" or "any email from Acme?", Orion's instruction is to search all your forwarded email, read and unread, before answering. If the search comes back empty, it should say it found nothing in what was forwarded to it — not that the person never wrote, because email sent to one of your addresses that is not forwarded to Orion, or that your mailbox did not forward (Gmail, for example, does not forward spam), never reaches it. And if it looked at only part of it (only the unread ones, or only the most recent results of a search with many matches), it should say which part — and when you ask it to open "the email from Acme" and more than one matches by sender or subject, it opens the most recent one and should tell you there are others. If an answer comes without that search, ask: "search the emails".

If nothing arrives, it tells you. When Google is connected but no email has ever reached the agent's address, Orion notices — because not even the provider's confirmation showed up — and sends you a message explaining what is missing. It does this once and repeats at most one more time, a few days later. After that, it stops.

Corporate email can block it. Many Google Workspace and Microsoft 365 admins block external auto-forwarding. If that is your case, ask IT to allow "external auto-forwarding" — or connect a personal email.

On Microsoft 365, Orion reads Outlook directly. Anyone who connected Microsoft has already granted read permission: when you ask, it reads the Outlook Inbox without this step. That read, however, does not go through the hourly opportunity classification — for Outlook to be included too, forward it to Orion's address (in Outlook: Settings › Mail › Forwarding). If you use both, forwarding still serves the mailboxes that are not in Outlook. The prospecting sending mailbox is a separate account, which Orion does not read, even when it is Microsoft: what reaches it only gets to Orion if it is forwarded (see "Forwarding the sending mailbox to Orion" under Prospecting).

When an email may be an opportunity

Every hour, Orion looks at every email that arrived forwarded — whatever the subject, whoever sent it, even someone who was in a prospecting sequence months ago — and picks out what may be a business opportunity: someone outside who asks for a price, a proposal, a demo or a meeting, wants to hire, partner or refer business, or picks up a sales conversation. A request that comes through a website form or a LinkedIn or Instagram message counts as a person's request, not as a notification; a form that arrives with your own address as the sender is judged by the reply-to address of whoever filled it in — or, without one, by the form's email field. An email you or a colleague forwards to Orion (from Gmail, Outlook or any other program) is judged by the forwarded request, and the person is whoever wrote the original — never whoever forwarded it; if the original is from someone in your company and whoever forwarded it is from outside, the person is whoever forwarded it. A reply to a conversation belongs to whoever replied, even with the quoted history below it — from a phone or from Outlook, and even if that history carries an old forward. A referral a colleague in your organization writes to you is looked at too.

How you find out. When a likely one shows up, it sends you one numbered notice: who it is, the company, the subject, the reason in a few words and whether it is likely or maybe — up to 5 items, and "and N more" when there are more. The maybe ones don't interrupt on their own: they ride along with the next notice or go out at 12:00 and 17:00. The notice respects your hours: 7:00 to 21:00 on weekdays; what arrives at night or on the weekend waits for the next weekday morning. At most 6 notices a day, and the same person appears once a day — unless they later send something stronger (a likely after a maybe). The numbers run through the whole day: today's 3 is a single email, even if it came in the second notice. An email you already opened while talking to Orion does not become a notice; a routine that reads your emails on its own does not count as you having seen it. A sender Orion could not verify is marked unverified sender. On the official WhatsApp line, if you haven't written on it in the last 24 hours, only a short notice saying how many emails there are arrives — reply and it shows you the list. If the notice doesn't go out (the channel is down), it tries again every hour within the notice hours, until 24 hours after the first failure — after that the email stays on the list and in the morning brief line; if no channel is connected, it tries once a day for 7 days — if you connect WhatsApp or Telegram later, you get what arrived before. A reply from a prospect in your sequence is notified by prospecting; if that notice doesn't go out — or if it is an out-of-office auto-reply with a request in it —, it comes in here after 2 hours. In the morning brief, the line Opportunities without a decision: N reminds you of the ones from the last 7 days you haven't decided yet. If you turned off the morning brief, you don't get this notice either; the classification, the list and the CRM keep working.

The Opportunities list. In Orion › Emails, the Opportunities card shows all of them — likely, maybe and the ones Orion couldn't classify — from the last 30 days (after the one-time read, from 30 days before the start): who it is, the subject, the reason and which account the reply would go out from. If there are more than 100, the ones you haven't decided come first and the card says there are more — Orion lists them all in the conversation. When the address shown is not the writer's (it is the form's, the social network's or whoever forwarded it), the item says so. Only you see this list: it is your mailbox (the organization Admin doesn't see a member's, and a member doesn't see the Admin's). On each item: See the text (only the new text, without the quoted history), Log lead (the contact goes into CRM › Pending actions by the writer's email address, with the subject — never the text; without that address, the card asks you to open the text and log it with the right address), Ask Orion to reply (opens the conversation with the request already written; it reads the whole email first, and the send goes through the usual confirmation; without a subscription, it gets a 🔒, like Ask Orion), Create task (on your list, due tomorrow), Put in a sequence (in an active prospecting sequence, with the usual locks: someone who asked to leave, a client and a country outside your prospecting don't go in) and Not a lead (that person's maybe stops interrupting you for 90 days; a likely one still notifies you; it can be undone — on a request that came without the writer's own address, the mark applies to that email only). What you decide is recorded on the email itself.

What you can ask. Reply with the number — "log number 1", "draft the reply to 2", "create a task for 3" — or ask "which emails may be opportunities?". The numbers run through the day; before acting, it tells you who it is and the subject, so you can confirm. With a send waiting for your yes, the number alone is still the notice's number: it never decides the send. When you ask what came in, it already tells you which may be opportunities. It reads the whole email before drafting, and every send goes through the usual confirmation. The reply goes out from your connected Google or Microsoft account — the one that received the email, if it is one of them; otherwise the one you connected — and it tells you which before sending. The prospecting sending mailbox only replies to people in one of your sequences.

What goes into the CRM on its own. On the organization Admin's account — or yours, if you use Orion without a company —, a likely opportunity from someone who is not yet a client goes into CRM › Pending actions: the contact is created from the writer's email address (anyone who already exists is not changed) and the line carries the subject and the reason, never the email's text. Another email from the same person updates the same line. In a forward, the one who goes in is whoever wrote the original — never whoever forwarded it, unless the original is from your company and whoever forwarded it is from outside; in a reply to a conversation, whoever replied goes in; and a request that arrives without the writer's own address (social network, a forward without it, a colleague's referral) does not go in on its own: you get the notice and the list, and you log it with the right address. Someone already on your personal list (Relationships) does not get a record in the organization — a person stays on one list only. On a member's account, nothing goes into the organization's Pending actions on its own, because the mailbox is theirs: they get the notice and the list, and log it if they want — with the Log lead button or by asking Orion. A client asking for more and someone you already disqualified never enter Pending actions on their own: they show up in the notice and on the list with the label already a client or dismissed before. A prospect whose sequence ended always shows up, with the label prospecting ended — whatever the subject, even if it doesn't look like a sales request (except an out-of-office auto-reply) — and gets an "email received after prospecting ended" line on their history — wherever the contact is: in the organization's CRM too when the prospecting is a member's, as the prospecting reply already is; if it is likely, it enters Pending actions like any other. The sequence does not restart and nobody replies on their own.

If classification fails, the email does not disappear. When an email cannot be classified in three attempts in a row, it shows up as couldn't classify on the list and rides along with the next notice — except bulk email (a newsletter, a promotion, an automatic report), which stays on the list only, out of the notice and out of the morning brief count. To classify, Orion uses the platform's AI models, as in the rest of the product; the subprocessor list says what each one receives.

What stays out. Only email forwarded to Orion is looked at. Left out: spam (Gmail does not forward spam), the Outlook inbox read through the Microsoft connection without forwarding (see the Microsoft 365 paragraph above) and the prospecting sending mailbox while it does not forward — someone who writes straight to it, outside the sequence, only reaches Orion with forwarding on. In the dashboard, Prospecting › Overview recommends turning it on when nothing has arrived from it — and again when nothing has come from it for 7 days —, and Prospecting › Settings › Sending mailbox shows the steps. Classification started on October 1, 2026. In the first days, Orion read once the emails from the previous 30 days: what could be an opportunity went onto the list (marked from the read of the previous 30 days), with no notice one by one and nothing sent to the CRM, and you got a single message with the count. Older emails were not classified. Opportunity classification also does not run on the inbox of someone removed from the organization, or of a suspended account — while the account is in that state, email that arrives is stored, does not go through this classification, no opportunity notice goes out, and that account's morning brief carries neither the email part nor the opportunities line. If the person is restored, what arrived in the meantime is classified within about a day, and the notice goes out as usual.

Third-party tools

Beyond Google and Microsoft 365, Orion can use external tools from a platform-approved catalogue. They live under Orion → Integrations, and the principle is always the same: you supply the credential for your own account. These tools are not part of your plan — the account and whatever it costs are yours, and Orion simply learns to operate them in your conversations.

The catalogue is curated: only tools the platform has reviewed get in. You do not register addresses of your own.

What an integration does outside Orion waits for your yes. Sending, publishing, commenting, spending credits or issuing something through an integration gets the same care as any send: the system holds it and shows you the draft — the action and the fields as they would go out — and only does it after your yes. Searching and reading need no yes. A tool the platform has not reviewed yet also waits for your yes.

Connecting takes three steps: paste the credential the tool gave you, click Connect, and the panel tests the connection right away. From then on each integration has Test connection, Pause and Remove — removing deletes the stored credential. When paused, it shows Enable and Remove; with an error (🔴 dot), Test connection and Remove.

Some integrations connect through the service's own screen. Instead of pasting a credential, you click Connect with…, authorize on the service's page — in the same browser, within 15 minutes — and come back to the panel. If the authorization goes through but the service doesn't provide its tools, the card shows a 🟠 dot and the reason: the integration is connected, but Orion can't use it yet. Click Reconnect; if it persists, contact support. The buttons follow the card's state: connected (🟢), Pause and Remove; paused, Enable and Remove; with an error (🔴), Connect with… again and Remove; and, while the authorization is not finished (⚪), only Connect with…. When the service tells Orion which account was connected, Orion keeps it: connecting again with a different account — through Reconnect or Connect with… — is refused without changing anything, and the page says the integration is already linked to another account; to switch, use Remove and connect the new one. If, on a new connection, the service stops saying which account it is, nothing is changed and the page asks you to try again. Not every service says which account came back; for those, a new connection has nothing to compare against.

One detail that often goes unnoticed: connecting an integration does not hand it to your AI workers. Each worker needs you to tick, on the Governance page, which integrations it may use. Unticked ones stay blocked for that worker even while connected.

When a search finds nothing. In a conversation, when Orion looks for something inside an integration and the search comes back empty, it tries at most once more, in a different way (another word, a shorter term). If that one also finds nothing, it stops searching that integration for the rest of that request and tells you so: what it didn't find and what it did not get to search, and it asks what to try next — another word, a specific place or person, a period. An empty search only means those words found nothing; it does not prove the subject is not there. With your next message it searches normally again.

If an action in an integration fails because of a timeout or a dropped connection, it may have gone through anyway — a message may have been posted, for example. Orion tells you exactly that — it may have gone through and is not confirmed, not that it failed — and does not repeat it blindly: it checks, when it can read the result in the service, or asks you before trying again. When in doubt, check in the service itself before asking again.

Invoicing

For customers in Brazil: the catalogue includes a Brazilian tax-document integration covering service invoices (NFS-e), goods invoices (NF-e and NFC-e) and transport documents, plus cancellations and correction letters.

Before counting on it, three things need to be clear.

It requires a digital certificate. For any invoice to be issued by software, automatically, the Brazilian government requires an ICP-Brasil digital certificate (A1 or A3) — it is what signs the document on the company's behalf. This is not a requirement of our platform or of the integration: it applies to every tax software in the country, with no exception and no shortcut. The certificate is configured in your account with the tax tool, not here. A Brazilian MEI who provides services? Orion MEI+ issues the NFS-e for you, with the digital certificate included — see the MEI chapter of the manual in Portuguese (orionworkers.com/manual/mei).

Without a certificate, the path is the government issuer. Anyone without a certificate — which is most sole traders in Brazil — issues free of charge on the official NFS-e portal and app, signing in with a gov.br account. There is a simplified mode there that asks for two fields: the customer's tax ID and the amount. The gov.br login works for issuing on screen; it does not work for automatic issuing by software.

Orion never issues anything on its own. No invoice is generated in the background, by an automatic routine, or without you asking. In your conversation, issuing only happens after your yes to the card that shows the invoice as it will go out. And, for safety, it does not issue in the turn in which it has just read outside content — an email, a page, a file or an integration's result, including a lookup in the invoicing tool itself —: it then tells you it did not do it. Just ask again in a message of your own, and the issue comes as a card. And when the request comes from an AI worker rather than from you, issuing is treated as a financial action: it follows your organization's autonomy policy and is never waved through just because an approved work plan existed. Even so, the habit matters: an invoice is a legally binding document, and the amount, the customer and the type of service you dictate are the ones that reach it.

Tax responsibility is yours. Orion is not your accountant and does not choose your service's tax code — you set that once, in the tax tool or in the government issuer. An error in the code, the amount or the recipient is the responsibility of whoever issued the invoice.

Canva

With the Canva integration, Orion creates presentations and images in your own Canva account from what you ask in the conversation, and saves the file in the library.

Availability. The Canva integration is being rolled out gradually. If the Canva card does not show up yet under Orion → Integrations, your account's turn has not come yet.

Connecting. Under Orion → Integrations, on the Canva card, click Connect with Canva and authorize your account on Canva's page. Each person connects their own account: there is no organization-wide Canva account.

Who pays. Creating a design uses credits from your Canva account, not from your plan — and Orion tells you so when it starts. Canva's free account has few credits per month; when they run out, Canva refuses to create the design and Orion tells you.

How to ask. The way you would say it: "create a 5-slide presentation in Canva about the quarter's results". If the presentation is for a deliverable, say which one — "…about the deliverable App launch". Orion reads the deliverable first and builds the content from its real data.

The wait. Canva usually takes one to two minutes. Orion replies right away that it is building it and, every so often, sends a line saying it is still following. When it is ready, the link to open the design in Canva and the .pptx file (or a PDF, if Canva does not export it as .pptx) arrive in the same conversation. If Canva takes longer than four minutes, Orion stops following and tells you — the design may still show up in your Canva account.

Where the file goes. By default, to your 🔒 Personal library (Knowledge → 🔒 Personal): only you see it. If the presentation is for a deliverable, the file goes into the deliverable, 🏢 Organization — as long as you can attach files to it (an Admin, whoever leads the deliverable's team, or someone who works on it). Before spending any credit, Orion checks the deliverable: if the name matches more than one, or none, it asks which one. The final message always says where the file went.

Images. You can also ask for an image: "generate an image in Canva of a lighthouse at sunset, in watercolor". It works the same way: it uses credits from your Canva account, Orion follows it until it is ready, and the link to open the image in Canva and the image file arrive in the same conversation, saved to your 🔒 Personal library — or into the deliverable, if the image is for one. For now, Orion creates the image only from what you describe: it does not yet send a photo of yours to Canva to edit.

Where it works. In your conversations with Orion: the panel, the app, WhatsApp and Telegram. Not in groups.

Miro

With the Miro integration, Orion takes the synthesis of the annual planning to a board in your own Miro account, for the workshop of the decision meeting. Orion uses Miro only in the annual planning: in the conversation, it does not touch your boards.

Connect. In Orion → Integrations, on the Miro card, click Connect with Miro — or, in the annual planning, Connect Miro, on the Miro strip at the top of the meeting's agenda. On Miro's page, allow access, sign in to your account and choose the team. Each person connects their own account: there is no Miro account of the organization. Once connected, the card shows the account under Connected as.

The daily limit. Miro works on all of its plans, including the free one, and each plan has a daily usage limit. Building the board uses part of that limit; if it runs out, Miro refuses, and the strip tells the time when you can try again.

Where it works. Only on the annual planning page, in the hands of the person who leads. The conversation, groups and customer service do not reach Miro.

Disconnect. In Orion → Integrations, Remove deletes the connection. The boards stay in your Miro account.

Slack

With the Slack integration, Orion works in your Slack workspace when you ask: it searches messages and channels, reads a channel or a thread, and sends or schedules messages. It finds channels by a word or by name: Slack does not let it list every channel you are in at once.

Availability. The Slack integration is being rolled out gradually. If the Slack card does not show up yet under Orion → Integrations, your account's turn has not come yet.

Connecting. Under Orion → Integrations, on the Slack card, click Connect with Slack and authorize your workspace on Slack's page.

Messages. Every message Orion is about to send or schedule in Slack gets the same care as any other send: the system holds it and shows you the draft, and it only goes out after your yes. Once it goes out, the receipt carries the link to the message, when Slack returns one. Searching and reading need no yes, because nothing goes out to anyone.

Connect your assistant (Claude, ChatGPT, Grok)

You can connect the assistant you already use every day — Claude, ChatGPT or Grok — to what Orion knows about your operation. Ask it there, "what did we agree with this client in June?", and the answer comes from here.

The direction matters, and it is the opposite of Integrations: there Orion uses third-party tools; here an outside assistant consults Orion.

Three different things are called "connecting", and they are worth telling apart. Connecting a channel means linking Orion to your WhatsApp or your Telegram so you can talk to it there — that is the chapter Connecting Orion. Connecting your assistant is what this part explains: the Claude, ChatGPT or Grok you already use starts consulting what Orion knows, and no key is copied anywhere. Bringing your own AI key (BYOK) is the opposite of that: there it is Orion that starts running on your AI provider's key instead of ours — it is a plan choice, and it lives in the chapter "Plans, leaving, and glossary". If you ask Orion to "connect Claude", it will ask which of those last two you meant.

How to connect

The simple path is signing in with your account. In your assistant, add a connector pointing at the address the panel shows under Orion → Integrations, and nothing else. It opens an Orion sign-in; you sign in as usual, see what is being asked for, and approve. Nothing to copy or store. The authorization lasts 90 days and you can revoke it whenever you like, on that same screen.

Before you approve, check where the access goes. Right under the assistant's name, the screen highlights the address that will receive the authorization — for example, Access goes to: claude.ai. The name is what the assistant says about itself, and anyone can pick any name; the address is where the authorization actually goes. When the destination is an app installed on your device, the screen says an app on this device.

The screen also warns you, before the Authorize button, when:

  • the name — or the address itself — looks like a well-known assistant, such as Claude, ChatGPT, Gemini, Copilot, Cursor, Grok or Orion itself, and the address is not one of the addresses we know for that assistant;
  • the destination is a program on your own device — that is normal for assistants that run on your computer, such as coding assistants;
  • the address is numbers only, not a website name;
  • the address has accented letters or letters from another alphabet — it then appears in its technical form, starting with xn--, so it cannot pass for another site.

The warning does not block anything: if the assistant is yours and you just started the connection, you can approve. If it wasn't you, refuse. With any warning except the one about a program on your device, Refuse takes you back to Integrations, not to the flagged address. Claude, ChatGPT and Grok, connected the normal way, show no warning. A legitimate assistant can show the warning when it receives the authorization at an address we don't yet know as its own; the same rule applies. And the warning does not catch every imitation: the address is what counts. Approve only if it really belongs to the assistant you use.

When you approve you answer two questions — and both start at the smallest scope:

  • How far can it read? "The organization only" (the default) or "also my personal layer".
  • Can it write? Unticked by default, and it is a choice separate from reach: you can keep reading to the organization only and still allow writing. When the reach is the organization’s, the screen warns you about the shared-key risk before you tick it.

If you would rather use a key — or if your assistant cannot do that sign-in — the same block lets you create one. Name the connection, copy the key right away (it appears once; after that we keep only a fingerprint of it) and paste the address into your assistant. A key lasts 90 days, you can hold up to five at a time, and revoking cuts access immediately.

What it can then see

Everything below arrives with the role of whoever authorized the connection — the person who approved the login or created the key — in the organization: what that person does not see in the panel, the assistant does not see either. If the person who authorized the connection is deactivated or removed from the organization, the connection stops responding.

From the organization: the pipeline snapshot, the revenue forecast for open deals, the open deals themselves and the people due for contact today; the deliverables and tasks, each with its progress and the original deadline alongside the replanned one; each team's delivery plans and the people's work plans, with cycles, reports and assessments; the dashboard, the teams and who is on each; and what is waiting on you — approvals, assessments, signatures and anything an AI worker wants decided.

And the decision record: what was decided, why, the context, the lessons and the deviations from the method. That is what separates an assistant that opines from one that checks what was already agreed before proposing. A decision later replaced is not presented as current. A note about someone's work plan — the explained deviation of a cycle, for example — only shows up for people who can open that plan, and the full archive of lessons, for Admin, HR and Audit.

Long lists come in pages and always state the total: if there are 245 deliverables and it showed 50, it knows 195 are missing and can ask for the rest.

Choosing "also my personal layer", it further reaches the conversation and decision history with each contact, your personal list (the one in the panel, which is yours and is not the organization's work) and the detail of work plans — which carry per-person assessments. With "the organization only", those stay out.

What it can change, if you allow it

With write permission it opens and updates deliverables, creates, updates and deletes tasks, records decisions, keeps your personal list and operates inside a plan — opens a draft work plan, adds and adjusts activities, records a cycle report and a progress note.

A decision stays at the organization level or is attached to a deliverable, a deliverables plan or a work plan. Attached, the panel's rule applies (whoever works on the deliverable; whoever leads the plan's team or a team above it; on a work plan, also its own person; and an Admin). Outside it, nothing is recorded, and it says why.

What it does not do through this connection, and why:

  • Make a pact — sign, assess, appeal or close a plan early. On the record a signature is yours; an outside assistant does not sign in your name.
  • Send — message, e-mail, invitation. That lives inside Orion, where the send confirmation and recipient guards are.
  • Create a CRM contact — a record about another person is created inside Orion, where the deduplication and organization-scope rules apply.
  • Delete work that has moved — a task with progress is not deleted through conversation, because removing a line silently changes the deliverable's progress. Zero the progress first, and then it is a deliberate act.

Two guarantees that always hold. It stays limited to what you can do under your role: if you cannot create a task in the panel, neither can it — and the same goes without a subscription, or on a plan without the team dashboard: what shows a 🔒 on screen it doesn't do either. On a plan without the dashboard, the Y Managers tools don't even show up in the connection; without a subscription, the connection stops answering (see below). And every act is recorded as coming from that assistant, with your name as the person who authorized it — which is why, if you allow writing on a key other people may use, whatever they have it create or change is recorded under your name. The screen warns you before you tick it.

It sees exactly what you see in the panel: nothing that was already outside your view appears through this path. And reading depends on an active plan — if the subscription lapses, the connection stops answering.

Ready-made questions

The assistant also receives a set of ready-made questions — in Claude they show up as slash commands, and you pick them, never the model. They save you from having to work out what is worth asking: prepare for a meeting with a client, close the week, "why did we decide that?", the state of a deliverable, "are we late?". With the personal layer you also get "what do I have today", and with write permission, "record a decision we just made".

The list respects what your connection reaches: a question the assistant could not answer with the scope you granted simply does not appear.

When new capabilities appear

The assistant caches the list of things it can do at the moment it connects. When Orion gains a capability, whoever was already connected keeps seeing the old list until reconnecting. Replies then carry a notice. To update it, remove the connector and add it again — reconnecting or starting a new conversation does not refresh the list: the assistant keeps the contract from the moment it was installed, and reconnecting only redoes the sign-in.

Where to paste it, in each assistant

The path differs per product and they change often. The summary below is the essentials; the complete, current instructions always live in each product's own documentation.

  • Claude — under Customize → Connectors, click + then Add custom connector, paste the address and click Next. Claude may say it "couldn't determine the server settings" — that is expected, carry on. Leave Authentication alone: Orion asks for the sign-in itself when you connect. Only choose None if you are using the key path, since the key already travels inside the address. On Team and Enterprise plans the organization owner adds it first (Organization Settings → Connectors → Add → Custom → Web); each person then connects their own. The free plan allows a single custom connector. Docs: Anthropic support.
  • ChatGPT — Orion is published in the ChatGPT app directory, so there is no address to paste here and no developer mode to switch on. Open Orion's page in the directory, install it and authorise with your Orion account — you see what is being asked before you approve. Then, in a new conversation, type @ and pick Orion to ask your question. Anyone on the key path still adds their own connector at chatgpt.com/plugins, choosing No authentication, since the key already travels in the address. Which ChatGPT plans can install the plugin is OpenAI's rule and it changes over time: if Orion does not appear for you, check their help centre. Orion's page: ChatGPT directory.
  • Grok — open grok.com/connectors, click New Connector, choose Custom and enter the server address. Docs: xAI docs.

Claude and Grok have a single address field — and so does ChatGPT, if you go by the key path. Signing in with your account, the address is short and holds no secret:

https://mcp.orionworkers.com/mcp

On the key path the key travels inside the address — and then treat it like a password: whoever holds that address reads your operation. If it leaks, revoke it in the panel and create another; it takes one click.

What it is actually good for

  • Prepare for a meeting without switching screens. "Before the Acme call: what have we agreed with them, what is still open, and what did we promise for this month?"
  • Write a proposal with the right history. The assistant already knows the price you charged, what was discussed and what was left out — you stop pasting context by hand.
  • Close the week. "Which deals are set to close this month and what do they add up to?" — the number comes from the same arithmetic the panel shows, not from an estimate.
  • Let nobody go cold. "Who should I have contacted and haven't?"
  • Answer an old question. "Why did we discount for this client back in June?" — the question no assistant without memory can answer.

Keep reading