Connect an agent: connector and email inbox

With a confirmed email inbox you can assign work to your agent and ōrbita tells it. The inbox only receives notices, with no data. To work in ōrbita it also needs one of these: the connector, which you authorise with your account and is what we recommend, its own ōrbita account or your password in its vault.

Updated Author: Mónica Lorenzo In the app: /connections

Two different things: the connector and the inbox

  • The connector is what lets your agent work in ōrbita. You authorise it with your account and choose what you allow. How: Connect your agent.
  • The inbox is an email address where ōrbita tells your agent that something has been assigned to it or that it was mentioned. With the inbox it hears about the work but cannot open anything: to work it also needs one of the options explained below.

An inbox does not change what your agent can do: it has the same rights as you in each company, never more.

Give it an inbox

  1. Go to Connections, to Your agents, and give an agent an inbox, or connect a new one and choose the email inbox.
  2. Write the name, the email and the companies where it will work. Give only a mailbox your agent controls, and accept the agent terms.
  3. ōrbita sends a code to that mailbox. Ask your agent for it, for example: “Check your email and give me the ōrbita code”.
  4. Write the code in ōrbita. If it does not arrive or it expires, press Resend to ask for another. If your agent is already connected with your account, it can also validate it itself.
  5. If you have not done so yet, connect it with the connector and choose this agent on the authorisation screen.

Until you write the code, ōrbita sends it no notices.

What it receives in the inbox

Only fixed notices such as “Te han asignado una tarea o una publicación” (“A task or a post has been assigned to you”): these emails always arrive in Spanish. They carry no title, text, company or names.

From the moment you write the code you can assign it tasks and posts, and the notice reaches it even if it is not connected. To work in ōrbita it also needs one of these: the connector, its own ōrbita account or your password in its vault. If you give it yours, the agent terms apply: you answer for what it does.

Nothing happens by email: ōrbita does not read replies, and a notice is never an instruction. Your agent tells you in the chat and you decide there.

When it acts

  • Your own tasks: if you are talking to it in the chat, it does them as usual. If it heard about them from a notice, it tells you first.
  • Somebody else’s tasks: your agent only knows they exist and who asks. It tells you and recommends reading them in ōrbita. It reads the text only if you authorise it, in the chat or in ōrbita. Another person wrote that text and it may try to manipulate your agent: read it first if you do not know who wrote it.
  • What shows outside ōrbita (scheduling or publishing, replying, changing your Google listing): your agent must show you the exact content and ask for your yes, one action at a time. ōrbita runs it when your agent reports that yes, and tells you it was done.

ōrbita does not see your conversation with your agent and cannot check that you said yes: it records what your agent declares. If you would rather the chat were not enough in your company, the owner can choose Only in ōrbita in the company settings.

What you should not give it

No agent needs your ōrbita password to work through the connector. ōrbita never asks you or it for one, and we recommend you do not give it.

If you decide to give it your username and password, you are the one authorising it to act on your behalf with all your permissions. To ōrbita that session is yours: what it does shows as done by you, without the limits, confirmations or record of a connected agent, and you take on the consequences.

  • Do not give it ōrbita keys or tokens.
  • Do not write payment, tax or health data in tasks and comments: ōrbita does not know what somebody writes in free text, and your agent could read it.
  • Share the code only with your agent. ōrbita will never ask you for it by message.

ōrbita does not send passwords, tokens, payment data, tax data or other people’s emails to any agent, by email or through the connector.

The provider of your agent

What your agent reads is handled by the provider you chose, under your contract with it, and that may be outside the European Economic Area. When you connect it, that provider also receives the data from your account shown on the authorisation screen, such as your email, name and photo. When it acts for your agent it does not act on behalf of ōrbita, even if ōrbita uses that same company for its own models.

If notices are paused

ōrbita pauses notices, and tells you, if your agent is connected and does not react to them, if its connection expires, if the email bounces or is marked as unwanted, or if somebody presses No soy yo (“It’s not me”). The line of your agent in Your agents explains what to do in each case.

Remove the inbox or retire the agent

  • Remove the inbox: it stops receiving notices at that email. It stays connected and keeps its work.
  • Retire: it loses access to ōrbita and stops receiving notices. This cannot be undone. What it has already done stays.

If you get an ōrbita code you were not expecting

Somebody wrote your address as if it were their agent’s. Ignore it, or press No soy yo (“It’s not me”) in the email, which comes in Spanish, so ōrbita stops writing to you about agents. That email gives access to nothing.

Published . Updated .