Compliance Keywords Messages
Last updated
Last updated
SMS Compliance keywords messages endpoints allow you to manage answers that are sent to compliance keywords (as STOP for unsubscription )
Compliance Keyword messages are only available for SMS
In order to set customized compliance keyword messages you will need to associate them with a type of keyword ( kw
) . Several types exist
Categories all keywords that indicate a subscriber's intention to subscribe or resubscribe to a service (ex START)
Categories all keywords that indicate a subscriber's intention to unsubscribe from a service (ex STOP)
Categories all keywords intended to provide simplified instructions to subscribers (ex HELP) .
Good practices require structuring HELP messages as follows
brand_name
, support_contact
(both URL or TFN or email ) followed by common_keywords
. For example:
Bird CRM: you can contact us at support@bird.com, send START to subscribe, STOP to unsbscribe. Msg & data charges may applies
Compliance Keywords Messages are always associated with the language; so for example. optin:en
Identify all keywords in English ( en
) that are used to identify a contact opting in to receive communications from a brand
Bird CRM system always listens for predetermined keywords categorized by type and language as below. Via the Compliance Keywords Messages endpoint you can customize the acknowledgment message each category will trigger.
HELP
help
info
OPT OUT
stop
stopall
end
quit
cancel
unsubscribe
OPT IN
start
begin
resume
revert
unstop
HELP
aide (french)
hulp (dutch)
hilfe (german)
ayuda (spanish)
ajuda (portuguese)
Aiuto (italian)
ПОМОЩЬ (russian)
POMOCY (polish)
OPT OUT
arret (french)
halt (german)
detener (spanish)
parar (pourtugese)
ferma (italian)
ОСТАНОВИТЬ (russian)
ZATRZYMAJ (polish)
OPT IN
nonarret (french)
This endpoint will return all the costume messages you have set in the target workspace
You can only define a message for a type of keyword and language (keywordMessageKey ).
You cannot have multiple messages for the same combination of type and language
If you want to revert to the default message, use the below methods with an empty value "value": ""
keywordMessageKey
indicates the keyword type and languages, for example for the example above it would be optout:en
When the filed lang
Is required, please specify a language using language codes
List all keyword messages for this workspace
The ID of the workspace
OK
Get keyword messages for this workspace and key (keyword:lang)