Cardinal by RAMCOREOpen Cardinal

Sending setup: Gmail, Cardinal mail and share links

AI agents and the runner. Email sending, now steps 2 and 3 of Comms › Sending setup: send invoices, quotes, reminders and replies for real, from your own Gmail or your own domain, with a link the client opens without signing in.

Cardinal can send your invoices, quotes, reminders and replies by email for real. Each workspace sends one way: from its owner's Gmail, or Cardinal mail from the workspace's own domain. Nothing leaves Cardinal until the owner switches on Send for real, and every message still needs a click or an exec's always-allow rule. Cardinal never sends one message twice: the same message sent again answers with the first one. The workspace owner sets it up under Comms › Sending setup.

Connect Gmail

  1. Open Comms › Sending setup and press Connect Google.
  2. Sign in to the Google account you send from. Allow Cardinal to send email on your behalf. That is the only Gmail permission it asks for.
  3. Gmail is connected through RAMCORE's Google app. While Google hasn't verified that app, you see an unverified-app screen the first time: choose Advanced, then Go to Cardinal. You see this once.
  4. Back in Cardinal, the page says "Sending as" and your address.

Mail goes from your own address and lands in your Gmail Sent folder. Cardinal never reads your mail. If Google signs Cardinal out (you changed your password, or removed the app in your Google account), the page shows Reconnect Google. Press it and sign in again: held messages then go out once each.

Connect Microsoft 365

  1. Open Comms › Sending setup and press Connect Microsoft 365. (If Gmail is connected, disconnect it first: a workspace sends from one mailbox.)
  2. Sign in with the work account you send from, and accept that Cardinal may send mail as you and read your basic profile.
  3. If Microsoft says you need an admin's approval, open "Your organisation blocks this?" on the page and send your admin the link there. Once they approve, press Connect Microsoft 365 again.
  4. Back in Cardinal, the page says "Sending as" and your address.

Mail goes from your own address and lands in your Outlook Sent Items. Cardinal never reads your mail. If Microsoft signs Cardinal out (an admin removed it, or it sat unused for 90 days), the page shows Reconnect Microsoft 365, and held messages go out once each when you do. Disconnect removes Cardinal's access; to remove the app from your account too, open My Apps.

Send from firm addresses

Cardinal sorts every message into one of three types and sends each from the address you pick for it, under Comms › Sending setup:

  • Accounts: invoices, reminders and payment chases on an invoice.
  • Business development: quotes and deal follow-ups.
  • General: enquiries, status updates and everything else.

Pick a default sender too; a type left on "Same as default" uses it. An address you choose when you approve a message still wins.

  1. Add the address in Gmail › Settings › Accounts › Send mail as and complete Gmail's verification. Gmail only sends as an address it has verified, and quietly uses your main address otherwise.
  2. In Cardinal, type it under Add a send-as address. Connections made before 2026-10-28 list the addresses from Gmail instead; for those, press Refresh aliases after adding it in Gmail.
  3. Give each address a display name and press Save name: clients then see, for example, "Satchel and Boot Accounts" instead of the bare address.
  4. Press Send a test beside the address. Cardinal emails you, at the address you signed in with, and nobody else. Open that email and check the from line in its details: Gmail shows mail you send to yourself as "me", so the details are the reliable place to look. Then answer Yes, it did or No, it came from another address.
  5. Yes marks the address "Tested on" the date. No means Gmail sent it from your main address: add the address under Send mail as in Gmail, then send another test.

A message from an address that has not passed its test waits as Held, with the reason and a link to this page. It goes once, after the usual checks, as soon as you answer Yes. Addresses typed before this release send as before and show "Added before tests; sends as before" until you answer Yes to a test, and Gmail's own listed addresses never need a test. The send form and Comms mark an address that will wait.

For a firm, connect a firm-owned Google Workspace account rather than a personal Gmail address, so clients see firm addresses. Cardinal warns on the page when the connected account is a personal one.

  • Every message shows its From, with its name, before it goes, and you can pick another address there.
  • If an address leaves your Gmail list, its messages wait as Held until you pick another one.

Cardinal mail, without Gmail

  1. Under Cardinal mail, enter your domain and the address to send from, and press Use Cardinal mail. Use your own domain: a free mail domain, or Cardinal's own, is refused.
  2. Add the DNS records Cardinal shows at your domain's host.
  3. Press Check again. DNS changes can take a few hours. Cardinal mail is active only after the DNS verifies; until then it can't send. A domain that isn't verified within 7 days is released, so another workspace that really owns it can set it up; you then see "Your domain wasn't verified in time and was released."

If the page says the domain is already registered with Cardinal's mail provider, ask Cardinal support to release it. Stop using Cardinal mail removes the domain here and deletes it at the mail provider too.

Replies, and a copy of every message, go to the reply email under Comms › Sending setup.

Send for real

The switch at the top of Comms › Sending setup. Off, approving a message records it in Comms and nothing is sent. On, an approved message goes at once. It won't switch on until Gmail is connected or Cardinal mail is verified. It also needs the server switch (CARDINAL_COMMS_LIVE, set by whoever runs this Cardinal, see below): with that off, the page says so and nothing is sent even when your switch is on. Your signature, set on the same page, goes above your firm's details and the opt-out line.

Sending an invoice or a quote

  • On an issued invoice, Send invoice opens the email as it will go: From, To, CC, the subject and the message. Edit anything; your click sends exactly that.
  • On an approved quote, Send quote does the same, with the quote's link and the deck's when there is one.
  • Sending marks the invoice or quote sent once the email has really gone.
  • Each invoice, quote or deck you send carries a link the client opens without signing in. It shows the document as it prints, with Download PDF, and for an invoice the bank details and the balance due.
  • The document's page shows the link with Copy and Revoke, and the day the client first opened it. Your own visits don't count.
  • Revoke stops a link at once. A voided invoice or a declined quote stops its link too. A stopped link only says "This link is no longer available."

When a message doesn't go

  • Held: Google signed Cardinal out, the From address left your list, or sending for real was switched off (the workspace's Send for real, or on the server) after the message was approved. Reconnect Google, pick another From, or switch sending back on, and press Send now. Held messages go out once each. Before a held message goes, Cardinal checks it again: if the address opted out, the invoice was voided (or, for a reminder, paid) or the quote was declined, it is blocked instead and says why.
  • Cancel: a held or failed message you no longer want can be cancelled in Comms. It never goes, and Today stops counting it.
  • Failed: the address was refused, or Gmail or Cardinal mail couldn't be reached. Retry shows only when trying again can help, such as a busy provider or a setup problem you have fixed. A setup refusal (Cardinal's Google app credentials, a Workspace admin block, the Cardinal mail key or its sending limit) says what to fix; nothing was sent, so once it is fixed Retry sends it once. When the first try may have gone out (a timeout), Retry warns that it may send a second copy. A refused message has no Retry: fix the address and send a new one.
  • Already sent: pressing Send on an invoice or quote with the same message as before sends nothing and says when it went. Change the message to send it again.
  • Sending for more than two minutes: Cardinal couldn't confirm it went. Look in your Gmail Sent folder, then choose "It went: mark as sent" or Send again.
  • A message that was blocked or cancelled after Cardinal tried to send it may already have gone, so sending the same text again answers with that one and never makes a second copy. One blocked before any try (for example by an opt-out at approval) can be sent again once the reason is fixed.

For the person who runs this Cardinal

Done once by the vendor, for every workspace. Customers only press Connect Google.

  1. In Google Cloud, signed in with the ramcore.io account, make a new project and enable the Gmail API and the Google Calendar API.
  2. OAuth consent screen: user type External, publishing status In production. An app left in Testing signs everyone out after 7 days. Add the scopes openid, email, gmail.send and calendar.events.readonly.
  3. Credentials: an OAuth client of type Web application, with the redirect URI https://cardinal.ramcore.io/api/connections/google/callback.
  4. In Vercel, set GOOGLE_OAUTH_CLIENT_ID and GOOGLE_OAUTH_CLIENT_SECRET for Production (and Development for local tests).
  5. On your own computer, make the key that seals the Google tokens and share links. Set CONNECTION_KEYS to what this prints, and CONNECTION_KEY_CURRENT to 1. Keep a copy in your password manager. Also set CARDINAL_PUBLIC_URL to the full web address your team opens Cardinal at, so share links point to the right place.
node -e 'console.log(JSON.stringify({"1":require("node:crypto").randomBytes(32).toString("base64")}))'
  1. Set CARDINAL_COMMS_LIVE to 1, and redeploy so the new settings take effect.
  2. In Cardinal: Comms › Sending setup, Connect Google, pick your senders, then Send for real.

Until Google verifies the app, up to 100 Google accounts can connect. A Google Workspace admin can mark Cardinal trusted (Security › API controls) so their users never see it. Cardinal asks for no restricted scope, so verification is the sensitive-scope review only. GOOGLE_OAUTH_SCOPES (a deploy setting) can replace the scopes; keep openid, email and gmail.send.

### Microsoft 365

Done once by the vendor.

  1. In Microsoft Entra, register a multitenant app named Cardinal. Add two Web redirect URIs: https://cardinal.ramcore.io/api/connections/microsoft/callback and the same with admin-consent at the end. Leave implicit grant off.
  2. Make a client secret (12 months) and copy its Value once. Diary the expiry: when it lapses, replace it or nobody can connect.
  3. Delegated Graph permissions, nothing more: openid, profile, email, offline_access, User.Read, Mail.Send.
  4. In Vercel, set MICROSOFT_OAUTH_CLIENT_ID and MICROSOFT_OAUTH_CLIENT_SECRET for Production, and redeploy.
  5. Before other companies connect, complete publisher verification; until then many organisations need admin approval.
  6. In Cardinal: Comms › Sending setup, Connect Microsoft 365, then Send for real.