Error codes returned by the carrier on SMS or MMS

You might receive error codes returned by the telephone carrier after you’ve sent a SMS or MMS.

The telephone carriers filter all the messages to protect the mobile subscribers from spam and other forms of unwanted messaging.

And, these systems look at both message content and volume.

Filtering in the United States and Canada can affect the delivery of your SMS and MMS messages.

Where do the error codes appear in aNinja

When in the lead view, in the history section, you can see error in red on the right corner under the sent SMS or MMS.

Hover your mouse over “error” to see the error code.

Error codes on SMS or MMS

Then, search for this code in the below section to understand the reason for this error.

Error codes references on SMS or MMS

Below are the most common error messages returned by the carriers.

  • 11751 => Media exceeds messaging provider size limit.
    • Maximum size limit depends on the messaging channel.
    • aNinja supports an MMS of 600KB.
  • 12300 => Invalid Content-Type.
    • Our carrier is unable to process the Content-Type of the provided URL.
    • You must return a Content-Type for all requests. Requests without a Content-Type will appear in the Debugger as a 502 Bad Gateway error.
  • 30003 => Unavailable or unreachable destination.
    • The destination handset you are trying to reach is switched off or otherwise unavailable.
  • 30005 => Unknown or inactive destination number.
    • The destination number you are trying to reach is unknown and may no longer exist.
    • The device you are trying to reach is not on or does not have sufficient signal.
    • The device cannot receive SMS (e.g. the phone number belongs to a landline).
    • There is an issue with the mobile carrier.
  • 30006 => Landline or unreachable destination.
    • The destination number is unable to receive this message. Potential reasons could include trying to reach a landline. Or, in the case of short codes, an unreachable carrier.
  • 30007 => Your message was blocked by the carrier due to spam, phishing, and fraud content.
  • 30008 => Delivery of your message failed for unknown reasons.
    • Our carrier receives a very generic error from the destination carriers that they have no further details about. They associates the message with the error code 30008 letting you know that they truly don’t know what caused this error from the provider.
  • 30019 => Content size exceeds carrier limit.
    • Message failed because the size of the content associated with the message exceeded the carrier limit.
  • 30410 => Provider timeout.
    • The provider used may be experiencing disruptions resulting in errors or request timeouts. Messages are failed and not retried to avoid duplicate message delivery.
  • 32017 => Carrier blocked call due to poor reputation score on the telephone number.
    • The calling number has a low answer rate from end users; or, generates low-duration calls; or it is responsible for large volumes of unwanted calls.

Text/SMS Signature

When sending a text/SMS via aNinja, you would want to include a text signature at the bottom.

What’s a text signature

It is a powerful way to convey your professionalism to your readers and give them the information they need to contact you. It is placed at the bottom of each text, which helps leave a great impression and makes you stand out from your peers.

You want to consider the size/segmentation of the text when you include a text signature to avoid being overcharged.

Setting your text/SMS signature in aNinja

  • Login to your aNinja account.
  • Go to Settings > Phone Numbers

  • Click on the edit pen

text signature

  • Type in your signature

text signature

  • And hit Update
  • Now your signature will show at the bottom of each text you send via aNinja.

This signature is sent in bulk texts as well. At the time you create your text sequence, the system grabs the lead info, templates that yo’ve included in the sequence, and the phone number assigned to launch this sequence.

However, if you change the signature after the sequence was launched, the system updates the in-queue steps.

Understanding SMS Text Segments & Billing

The text messages (SMS) are composed of segments. And each segment is 160 characters of text.

When you send a text that contains more than 160 characters, it is actually billed as multiple texts. These are technically called text segments. And billing counts the number of text segments and issues the charges accordingly.

When you prepare a text template, or you’re about to send a text to a lead from the lead view, you might like to include emojis and special characters to give it a nice design.

We’ve included a character counter to help you monitor the size of your text template. It’s also important to understand how many texts you are billed for.

There is a fixed character limit for one text (160 alphanumeric characters per SMS text segment). Emojis and special characters might be counted differentlyYou also might want to watch out for invisible characters.


What’s an SMS text segment or Segmentation

SMS industries count messages before sending them through your carrier. They count the number of characters that a text contains. Each segment is of 160 characters. But sometimes the character limit exceeds, and one text is converted into two. You’d end up with two messages on your bill.

Maximum Message Length with aNinja Messaging

The aNinja Programmable Messaging platform has a limit of 160 characters in a single incoming or outgoing message request. And that’s based on the text segmentation standard.

When you go over that, the system is automatically creating additional text segments to send out your longer message.

Additional Considerations for Long SMS Messages

Although aNinja supports large message payloads for all Messaging Channels including SMS; it is important to understand that some wireless carriers and devices may behave differently than others when receiving long SMS messages.

In addition, the size of an SMS, and which characters are present (e.g. emojis, signs, and symbols) affect its price, based on segmentation.

Some things to consider
  • Try to keep your texts to a max of 160 characters to have a one-to-one mapping of texts sent to text segments billed.
  • Emojis count as multiple characters.
  • Eliminate smart quotes, signs, and symbols before sending messages.
  • If you’re using emojis or special characters, try to keep your SMS to 70 characters or below.
  • Count up the SMS text segments before you run a campaign instead of after. When preparing your text template, have a look at the segment/character counters included at the bottom corner of the text template. Counters are also available in the text feature in the lead view.
  • Also, check for invisible characters in your template if you pasted the template content from a word document or similar. The characters counter would then indicate e.g. 4 segments when the total number of characters is 270/160, representing 2 segments.
  • Host a media file on your website or a file hosting service. Then add the link to download it in your text. (Instead of sending the media file in MMS).
  • Lastly, check this article for more recommendations before texting.

Schedule your text message

In this article, we show you how you can schedule your text message to delay the delivery to send it at a later time and date.

To reach out to your lead, you can send them a text message via aNinja.

Start Messages and create a text message, but don’t send it. Choose the time you want to send the message.

Scheduling a text to be sent later

  • On the lead view, click on the Text from the toolbar.Schedule your text message
  • Create the text but don’t send it.
  • Next to the send button, click the arrow to choose the date & time.
  • Then, hit Schedule > Send.
  • As a result, on the set date & time, the system sends the text to your lead.

Rescheduling a text

  • On the lead view, locate the text in the history section and click Reschedule.
  • Then, choose the new date & time and hit Schedule.

Cancelling a scheduled text

  • On the lead view, locate the text in the history section and click on Cancel.
  • As a result, the system will cancel your text.
  • Cancelling the scheduled texts is enabled on the web app but we don’t have it on the mobile app yet.

Checking the status of the scheduled text

You can see the scheduled texts only on the date they’ve been created. They don’t get rendered again when sent.

So you can check them in the lead view. Go back through the lead interactions to the date when the scheduled text was created.

The status of the text is on the right bottom of the text.

  • Scheduled for day & time: The text is still not sent until the day & time are due.
  • Success: On the set date, the system sent your text successfully.
  • Cancelled (was scheduled): This is a text that you cancelled.

Notifications on incorrect lead contact data

The Lead contact is the lead info saved in the Lead View (email addresses, phone numbers, URLs). When the lead is created, the contacts are saved as entered/provided.

The system uses the lead contacts to send your emails and texts. This means, in case the lead contact was incorrect, your outbound will surely not reach the lead.

Notifications on unsent emails outbound

You receive an email notification that the email address of this lead is incorrect and your outbound did not reach them.

Notifications on unsent texts outbound

You can see an error message in red in the lead history.

Notifications on incorrect lead contact data

Note: You also receive an error message after you send a text if the primary phone number is a landline number.

You can handle the outgoing SMS with an error code through triggers. e.g. mark as “do not contact” the lead with a landline number.

Message Statuses for the Bulk Text Sequences

Bulk text sequences message statuses” refer to the status updates associated with the delivery and processing of text messages sent as part of a bulk SMS campaign.

These statuses can provide valuable information about the status and count of messages and the success of the campaign.

Where can I see the bulk text sequence message statuses

  • You can see the Bulk text sequence message statuses in the Dashboard Widget “Bulk Sequences”.
  • However, if you can’t see this widget on your dashboard, just enable it from the little gear on the top right of the Dashboard.
  • For an overview of the dashboard, go ahead and click on the help (?) icon next to Dashboard.Bulk Text Sequence Message Statuses

Bulk text sequence message statuses

Bulk text sequence statuses indicate the status of the bulk sequence:

  • Being processed: The system is preparing your Bulk text for delivery.
  • Canceled: This indicates a Bulk text that you have canceled.
  • Done: The system has successfully delivered the Bulk text to all the recipients with a confirmation from the destination carriers.
  • In progress: The Bulk text is on the way and it started to reach the recipients gradually.

The bulk sequence sets itself to completed once all the messages have gone out.

In some cases, some messages get stuck in the “Outbox” because the carrier doesn’t return with a reply. The status of those messages changes to “Delivery unknown” in a few days.

Usually, the standard protocol is to give the carrier a window of 48 hours after the last SMS was sent successfully, before closing the bulk sequence (status done).

Count of messages

The stats column displays the count of messages in different stats, which includes:

  • Error: The texts did go out through our Carrier, but they were not delivered to the lead.
    • You can check the description of the error message in the lead view.
      • In the Bulk Sequence widget, click on the blue number next to “error”; then click on the name of the lead. In the history of interactions, you can see an info bubble next to the error under the text. Hover over it to see the message.
  • In-queue: The messages are in-queue and waiting to be sent out.
  • Outbox: The messages have been sent through aNinja, and the system is awaiting confirmation of success from the destination Carriers.
    • Click on the info bubble next to “outbox”: “Awaiting response from destination carrier”
    • Some destination carriers don’t return a confirmation message.
    • In this case, the status of the sequence remains “in progress” even though the messages went through aNinja.
    • And it will change to “Delivery Unknown” in a few days if we didn’t receive from the Carriers.
  • Sent: The messages were successfully sent out and the destination carriers confirmed delivery success.
  • Deleted_leads_count: This indicates the leads that were part of the initial request but have been deleted since the request was made.

Error type: Unknown error

If a message you sent is not delivered to the end device and returns a 30008 error code, this means that the delivery of your message failed for unknown reasons.

When our carrier receives a very generic error from the destination carrier that he has no further details about, he then associates the message with the error code 30008; letting you know that he truly doesn’t know what caused this error from the provider.

Possible reasons:

  • The phone/device you were sending to is not turned on or can’t receive messages.
  • Or, the phone is roaming or off-network. They cannot guarantee message delivery on roaming phones.
  • Or, the issue is likely device-related. Test sending to other phones who have the same mobile carrier.

We can still contact our Carrier to connect with the destination carriers to ask about the reasons/explanations for the unknown error.


As per the US country guidelines:

Gambling content being sent in the US is not allowed.

For reference, here is the documentation for sending MMS:

aNinja Centralized Inbox

The aNinja Inbox is a centralized view of all your incoming communication emails, textsvoicemails, missed calls, open tasks, and the chatbot conversations too.

Accessing the Inbox

On the left sidebar, click on Inbox icon.New Centralized Inbox

Inbox activities

You should be able to work exclusively from your aNinja Inbox.

From your Inbox items, you can:

Dynamic Inbox

The Inbox badge in the sidebar dynamically updates to show you how many Inbox items are available.

Concluded Tasks

  • Ultimately, all items of the aNinja centralized inbox should be completed on daily basis. However, if that was not possible, you can report them to the next day. Just toggle all the remaining items of the inbox and click on future in the toolbar.
  • The Inbox badge in the sidebar will show a green checkmark when all your Inbox items are done!

Task Management

  • You can also bulk mark inbox items as done / not done.

  • Answering a Lead from the Lead view (send/reply to an email, or send/reply to text) will automatically mark previous inbox items of the same type (e.g. email/text) as done.
  • Admin users can view inbox items for other team users, as well as filter them by type.

aNinja Reports

Get reports on the workflow of your latest activities and interactions that you’ve made in aNinja in a certain period of time. aNinja reports are simple, understandable, and provide you with a detailed view of your business performance.

When every user can see his reports, admin users can see the reports of all the users.

On the top right of the reports page, you can select the period and the user you want to check his reports.

Accessing the Reports

On the left sidebar, click on Reports icon.aNinja reports

aNinja reports

Below are the reports provided by aNinja:

  • Workflow Summary (ASR)
    • See All Steps Reached across the workflow.
  • Workflow Summary (LSR)
    • See the Last Steps Reached across the workflow.
  • Leads
    • See figures of the leads, created and Via API.
  • Opportunities
    • See figures of the Opportunity statuses.
    • On the right corner of the Opportunity report, see the details of the leads’ opportunities.
  • Emails
    • See figures of all the sent and opened emails, and the open rate.
  • Texts
    • See figures of the incoming and outgoing texts.
  • Calls
    • See figures of the outgoing calls and their total duration.

History of Interactions and Activities of a lead

aNinja brings you the history of all interactions and activities made for a lead in the lead view.

What’s the history of interactions and activities

Since the creation of a lead in your aNinja account, the system saves all the interactions and activities that you have made to this lead, in the history section.

Moreover, they are listed in ascending order. So, the users and team members are kept in the loop of the actions performed on this lead.

In the history you can view:

  • Calls made and their durations.
  • Emails that are sent & received with this lead.
  • Notes that are left by any team member so any other user stays updated on any relevant info.
  • Texts that are sent to this lead.
  • Tasks that are assigned and their statuses.
  • Workflow steps changes.
  • Chatbot conversations that are initiated by this lead.
  • Triggers

Accessing the lead history

From the lead view, in the middle right of the page, you can see all the interactions and activities of the lead.The history of all interactions and activities for a lead

Automated Texts time window

With the automated Texts time window, you can schedule your texts so that they arrive at the most optimal time.

If your audience didn’t respond to a sequence previously, it’s likely because the timing wasn’t right. Experiment with different timings to see what works best. Consider sending texts during the weekend or early morning, when people are more likely to check their phones.

Specifying the time window for sending out text messages

  • Enable the “Only send automated texts within acceptable time window”
  • And set the start / end / timezone accordingly.

Benefits of sending messages within an acceptable time window

Sending text messages within an acceptable time window has numerous benefits, including:

  1. Increased Open Rates: If you send messages outside of business hours or during times when people are unlikely to be looking at their phones, your messages are more likely to go unopened or unnoticed.
  2. Improved Response Rates: You’re more likely to receive a response from your recipients.
  3. Enhanced Engagement: You’ll build stronger connections with your audience.
  4. Increased Conversions: You ensure that your messages are being received and acted upon. And you’re more likely to convert recipients into customers.
  5. Better Customer Experience: You’ll provide a better overall customer experience. People appreciate messages that are sent at times when they are more likely to be available and receptive