This event is fired every time a contact in your account has responded. Event is sent to you in real time. The data payload format is the Message Object.
{
"type": "MESSAGE_RECEIVED",
"ctime": 1619552282398,
"data": {
"cid": "c_k123g456c789",
"phone": "5555555555",
"name": "John Smith",
"proxy": "8443035634",
"logid": "rl_1234.....",
"flags": ["dnd"],
"text": "STOP",
"sent_time": "02/04/2025 02:35PM EST",
"action": "1",
"contact_flags": ["dnd","replied","voter"],
"contact_source": "123456"
}
}
opt-out
occurs when a contact sends STOP keyword, once detected we add the dnd
tag to the flags list. Only the system can add this tag so this is reliable indicator of out-out use case.
bad number
occurs when we detect a complaint about wrong number, mistake or other common conditions about the message sent to wrong destination. In this case, we add tag bad
to the flags list.
rude
tag is applied when offensive or curse words in the message is detected. Detection is for most common English and Spanish curse words.