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.