Apeiron default handling for opt-out keywords on longcodes




Apeiron, by default, handles standard reply messages such as STOP, UNSUBSCRIBE or CANCEL for long code messages in accordance with industry standards.

Supported opt-out and opt-in keywords on long code messaging include:

  • STOP
  • STOPALL
  • UNSUBSCRIBE
  • CANCEL
  • END
  • QUIT

Any of these words when received will stop customers from receiving messages from that particular Apeiron number. When attempting to send a message to a subscriber that previously texted in any of the keywords mentioned above, Apeiron's API will throw a 500 response - "[tonumber] is unsubscribed from [fromnumber]".

If you are using more than one long code, customers who text STOP, STOPALL, UNSUBSCRIBE, CANCEL, END or QUIT to one of your long codes will not be prevented from receiving messages sent from other of your long codes unless you take additional action separate from Apeiron to prevent that from occurring. In addition, only single-word messages will trigger the block. So, for example, replying “STOP” will stop the customer from receiving messages from that particular Apeiron number, but replying “STOP PLEASE” will not. Further, the block works and is logged even if your number currently has no messaging request URL.

START, YES and UNSTOP will opt customers back in to the messages coming from your Apeiron phone number, and these messages will also be delivered to your Apeiron account as well as the defined web hook so you can update your application logic.

By Default HELP and INFO will not return a message informing the customer that they can use the above commands to control the delivery of messages but this behavior can be programmed.

Note:Text message campaigns may be subject to various legal compliance requirements depending on the nature of your text messaging campaign, the location from where you are sending your text messages, and the location of your recipients. While Apeiron will handle the above-described messages on long codes in the way described in this article, you should consult with your legal counsel to ensure that your text messaging campaign conforms will need to meet all applicable legal compliance requirements.