Skip to content

AptiveAI Messaging

AptiveAI Messaging lets your agents send text messages and emails to people who do not use AptiveAI Agents: the drivers who missed a step, the customer whose order changed, the supplier waiting on an answer. It is a connector that AptiveAI runs for you: texts go out from AptiveAI’s own toll-free number, +1 844-571-9591, and emails from an address of your own on AptiveAI’s sending domain. Email is included in your plan, up to 250 emails a day per business; texts are paid from your enterprise wallet. There is no number to request and nothing to verify: AptiveAI registers the number with the carriers itself.

It sits beside the connectors you sign in to yourself. If you already send texts through your own Twilio account, the Twilio SMS connector keeps working as it does; AptiveAI Messaging is for everyone else, with no account of your own to set up.

  1. Open Connectors from the sidebar and choose AptiveAI Messaging in the catalogue.
  2. Press Turn on. A dialog says what it does and what it costs: agents you allow can text and email people outside AptiveAI Agents, email is included in your plan up to 250 a day, texts are paid from your enterprise wallet, a task someone is watching asks before it sends unless someone pressed Approve all in it, and an automation set to run on its own sends without asking.
  3. Press Turn on again. Your enterprise now has one AptiveAI Messaging connection, owned by the organization rather than by you, so it keeps working if you leave.

Email works straight away. Texts start by themselves once the carriers approve AptiveAI’s number (see How texts are sent): until then the connector’s page says texts are Not available yet, agents are not offered the text tool, and a text send is refused without a charge.

The connection has its own page, Connectors → AptiveAI Messaging, with these sections:

SectionWhat is in it
StatusWhether email is ready and the address it sends from; whether texts are Available or Not available yet; what was spent this month
EmailThe Sender name — the From name on every email and the start of every text — and the Reply-to address, where replies go
TextsWhether texts are available, and that they go out from AptiveAI’s number starting “AptiveAI for” and your sender name. There is nothing to fill in
SpendingAn optional Monthly limit in dollars for texts, and this month’s spend against it. Email is included and shows no charge
ActivityEvery message your agents sent
Opt-outsWho cannot be messaged, and why
SharingWho may grant AptiveAI Messaging to their agents
Danger zoneTurn off and Remove

Every text your agents send goes out from one AptiveAI toll-free number, +1 844-571-9591, which AptiveAI registers with the US carriers. AptiveAI’s own notices to its users go out from the same number. You do not request a number, fill in a form or wait for a review of your business, and the number costs you nothing.

  • Every text starts “AptiveAI for ‹your sender name›: ”, so the person knows which business it is from. Set the name under Email → Sender name.
  • The first text AptiveAI’s number ever sends to a phone number ends ” Reply STOP to opt out.” That counts across all of AptiveAI, not per enterprise: if the number has already texted that person for another business or for AptiveAI itself, yours does not repeat it.
  • STOP stops everything from the number. A person who replies STOP to any text gets no more texts from AptiveAI’s number: not from your agents, not from any other business’s agents, and not AptiveAI’s own notices. HELP gets a reply naming AptiveAI and its support contact, dev@aptiveai.io. See Opt-outs for how this shows up on your list.

Two steps, as with any connector:

  1. Share it from its Sharing section with the people who should use it. They get Can use only: whatever share someone holds, only an owner of your enterprise changes the settings, the limit, turns it off or removes it.
  2. Grant it to an agent in that agent’s builder, like any other connector.

An agent granted AptiveAI Messaging gets three tools:

ToolWhat it doesLimits
Send a text messageTexts one message to a list of US phone numbers1 to 50 numbers; 1 to 1,600 characters
Send an emailEmails one message to a list of addresses1 to 50 addresses; subject up to 200 characters; plain-text body up to 20,000 characters; up to 10 files from the task attached, 20 MB in all
Check message statusLooks up whether messages this task sent were deliveredOnly messages from the same task

Sending to a list is one call, so one approval covers the whole batch — “text every driver on this list” is one decision, not fifty.

  • US numbers only. A number from another country is refused.
  • Every text starts “AptiveAI for ‹your sender name›: ” — “AptiveAI for Acme Logistics: …” — so the recipient knows who it is from, as carriers expect. The name is written in plain letters, with accents removed.
  • The first text to each number ends with ” Reply STOP to opt out.” That is once per phone number across all of AptiveAI, not once per enterprise or per agent.
  • Curly quotes, long dashes, ellipses and non-breaking spaces are replaced with their plain equivalents, so the message stays in the standard text alphabet.
  • A text is billed in parts (segments): up to 160 characters in one part, 153 per part when it is longer. A character outside the standard alphabet, such as an emoji, makes it 70 characters in one part and 67 per part. The approval card and the Activity list always show the number of parts.
  • They are sent from your sender name at your enterprise’s own address on AptiveAI’s sending domain — Acme Logistics <acme-logistics@notify.aptiveai.io> — with your Reply-to address, so replies come to you.
  • The body is plain text in a simple layout, with no AptiveAI marketing.
  • Every email carries an unsubscribe link and a one-click unsubscribe header.
  • Files from the task can be attached: up to 10 files, 20 MB in all. The approval card lists each file by name before anything is sent.
  • Included in your plan, up to 250 a day. Each business may email at most 250 people a day (counted per recipient; the day resets at midnight UTC). A send that would pass it is refused before anyone is asked, the agent is told to try again tomorrow, and the enterprise’s owners get a notification, at most once a day.
  • A link to a task can go in an email: ask the agent to send the link to this task, or another of yours, and say where it stands. The link opens only for people signed in to AptiveAI Agents who may see the task, so for a customer or anyone outside your business the agent puts the status and the result in the email instead. See Where a task stands, and its link.
  • A link to a file works for anyone: ask the agent to share one of the task’s files and email the link. The link opens that one file without signing in, for 24 hours unless you ask for 48 or 72. See When the agent shares a file.

A message cannot be unsent, so a send is a write that asks first, like any other connector write.

Where the send happensWhat happens
A task someone is watchingEach send asks, until someone presses Approve all in that task. The card shows the recipients (all of them, folded past ten), the message exactly as it will arrive, the number of parts and the charge (“Included” for email). After Approve all, later sends in that task go out without a card
An Autonomous automationThe agent sends without asking, and the transcript records each send
An Interactive automationIt stops at each send and waits, like a watched task, unless Approve all was pressed in that task
The Try it pane of the agent builderNothing is ever sent or charged. The agent is told what the send would have done — how many people, how many parts, about what it would cost
A skill’s trial or a training testNothing is ever sent or charged, whatever changes you let the test make. The agent is told what the send would have done, as in the Try it pane

An agent can only message a phone number or address that came into the task from somewhere you trust:

  • a message a person wrote in the task;
  • what a connector returned in the task, including the files it returned;
  • the agent’s knowledge files, or a file attached to the task;
  • text the agent read on a web page with its browser;
  • the output of code the agent ran in the task, or a page of these docs.

A number or address the agent produced from nowhere — made up, or remembered from another task — is not sent, and the agent is told which recipient was not found. Each message records where its recipient came from, and the Activity list shows it.

A send is also refused, before anything is charged, when:

  • a recipient is on your enterprise’s opt-out list, or replied STOP to AptiveAI’s number (to any business);
  • a number is not a US number;
  • AptiveAI Messaging is turned off, or texts are not available yet;
  • an email would pass the business’s limit of 250 emails a day;
  • a text would pass your monthly limit, or your wallet cannot cover it.

These checks run on every send, also after Approve all: it only skips the question.

If any recipient in a batch is refused, nothing in that batch is sent. The agent is told which recipients failed and why, and may send again to the rest.

Email is included in your plan, up to 250 emails a day per business: no charge, and no wallet needed. The approval card and Activity show it as Included.

Texts are paid from your enterprise wallet — never from the AI credit included with your plan or from promotional credit. Today a text costs about 1.8¢ per part; the turn-on dialog and the pricing page always show the current figures. The toll-free number itself costs you nothing. The up-to-160-character part count includes the opening “AptiveAI for ‹your sender name›:”.

  • A text’s charge is known before it goes out, so a send your wallet cannot cover is refused rather than run up as a debt. Add funds to your wallet to send again — having AI credit is not enough. See Usage and credit.
  • A monthly limit in the Spending section stops texts once this month’s texting would pass it.
  • When a send is refused for the wallet, the monthly limit or the daily email limit, the enterprise’s owners get a notification, at most once a day.
  • If the carrier refuses a text outright, that recipient’s share is refunded. A message that was accepted and then fails to arrive is not refunded.

Messaging spend shows up as its own line: on the task, beside AI usage, and on the wallet card of Activity. It is never counted as AI usage.

Two lists keep people from being messaged. Between them, nobody on either can be messaged by any of your agents.

Your enterprise’s opt-out list is the one on the Opt-outs section.

How someone gets on itShown as
They reply STOP to a text your agents sent themReplied STOP
They replied STOP to AptiveAI’s number after a text from some other business or from AptiveAI itself, and your agents had texted them beforeOpted out elsewhere (a STOP to AptiveAI’s number, or the carrier’s list)
They use the unsubscribe link in an email and confirmUnsubscribed
An email to them bounces permanentlyBounced
They mark an email as spamMarked as spam
An owner adds themAdded by an owner

AptiveAI’s own STOP list covers every business at once. A person who replies STOP to AptiveAI’s number is on it for good, whichever business or AptiveAI notice they were answering, and no agent of any enterprise can text them. It is not something an owner edits. Your Opt-outs section shows such a person only if your agents had texted them; it does not list people you never messaged. A send to anyone on it is refused before the approval card, and before any charge.

An owner can add a number or address to your own list under Opt-outs → Add an address. Nobody can take an address off a list. The unsubscribe link in an email opens a page that asks the recipient to confirm, so a mail scanner that follows links cannot unsubscribe anyone by accident. Email opt-outs apply to your enterprise only.

The Activity section lists every message your agents sent: when, the channel, the recipient, where the recipient came from, the status, the number of parts, the charge, and whether a person approved it or an automation sent it, with a link to the task. Filter it by channel, status or agent.

StatusWhat it means
QueuedCharged and about to go out
SentHanded to the carrier or the mail service
DeliveredThe carrier or the recipient’s mail service confirmed it
FailedIt was accepted but could not be delivered
BouncedThe recipient’s mail service rejected the email
Marked as spamThe recipient reported the email
RefusedRefused outright, and refunded
UnknownIt is not known whether it went out; it is not sent again on its own
  • Turn off pauses it: every send is refused at once. The history and the opt-out list are kept, and an owner can turn it on again at any time.
  • Remove turns it off for good. The messages sent and the opt-out list are kept.

AptiveAI may turn AptiveAI Messaging off for an enterprise when it sees abuse — for example many complaints, opt-outs or bounces. While AptiveAI has it turned off, only AptiveAI can turn it back on, and it cannot be removed; contact your AptiveAI contact. Messages may only go to people who agreed to receive them, never to a purchased list, and carriers’ rules apply (see the Terms of Service).

What protects the people your agents message, and your enterprise:

ProtectionWhat it does
Owner controlOnly an owner of your enterprise turns it on, sets the monthly limit, adds to the opt-out list, turns it off or removes it. The connection belongs to the organization, not to a person
A person approvesOn a task someone is watching, each send asks until someone presses Approve all in that task; the checks below still run on every send. The Try it pane, a skill’s trial and a training test never send. See When it asks first
Recipient guardAn agent can only message a number or address that came into the task from a trusted source, and every message records where its recipient came from. See Who an agent may message
LimitsAt most 50 recipients per send, 250 emails a day per business, US numbers only for texts, and your monthly limit for texts. A text your wallet cannot cover is refused before it goes out
Opt-outsA STOP reply stops every text from AptiveAI’s number to that person, for every business and for AptiveAI’s own notices. An unsubscribe, a bounce or a spam report blocks that email address for every agent of your enterprise, and nobody can take an address off a list. The unsubscribe page asks the recipient to confirm, so a mail scanner cannot unsubscribe anyone. A HELP reply gets AptiveAI’s support contact, dev@aptiveai.io
Sender identityEvery text comes from AptiveAI’s one toll-free number, registered with the US carriers by AptiveAI before texts start, +1 844-571-9591, and starts “AptiveAI for” and your sender name. Email comes from AptiveAI’s sending domain, notify.aptiveai.io, sent through Amazon SES and kept apart from AptiveAI’s own account email (sent through Azure Communication Services), authenticated with SPF, DKIM and DMARC
Signed updatesDelivery updates and STOP replies from the delivery service are accepted only when the service has signed them
Encryption in transitMessages travel encrypted between AptiveAI and the delivery service. A text is not encrypted once it reaches the mobile carrier, so keep messages to what the recipient needs to act on
A record of every messageActivity keeps the recipient, where it came from, the message as sent, whether a person approved it or an automation sent it, its status and its charge. Passwords and codes sent to a task are hidden in the stored copy
Abuse monitoringAptiveAI watches complaint, opt-out and bounce rates, and turns AptiveAI Messaging off for an enterprise that abuses it
No health informationAptiveAI Messaging is not offered under a HIPAA Business Associate Agreement and must not carry health information
ActionWho
Turn it on, change the sender name, reply-to address and monthly limit, add to the opt-out list, see Activity, turn it off or remove itAn owner of the enterprise
Share itAn owner of the enterprise
Grant it to an agentAnyone it is shared with, in an agent they may edit
Have an agent sendAnyone whose agent it is granted to and who may use it
Turn it off for abuse, and back on after thatAptiveAI