Inbound SMS from a number that is not yet a contact within our system should follow a high priority onboarding work flow.

[TheRealAlexV]

Some background: The current functionality of Spoke does not include handling for received text messages that are received from numbers not already in a campaign.

The purpose of this task is to implement a feature that allows us to handle text messages from unrecognized numbers.

What should happen when we receive a text message from a new number?
Note, this feature is certainly up for discussion, please feel free to include any suggestions or changes to this feature.

The number is auto-responded too with an Opt-In request. The Opt-In request will look something like this(Full text provided later..): "Hi there! Thanks for sending a text to CheckUpOn.Me! If you would like to be texted by one of our volunteers, please reply to this message with the word "YES"."

If the user responds back YES or any form of YES: Add the user into a new "onboarding" campaign. --- From this point, a volunteer will onboard PIN(Person in need), collect relevant info, ect. More to come on onboarding process. An e-mail should be sent when this happens using the built in spoke e-mail mechanism. (It should act similar to how text reply's currently email volunteers.) Optionally: It would be great to be able to log this info to a google sheet as well.

If the user respond NO, or any form of NO: Add the user to the built in Spoke Opt-out list. Note: Maybe we should keep our own Opt-out DB as well, since we'll likely cycle the spoke DB periodically.

If the user doesn't respond yes or no: Add this user to a campaign labeled "unverified". Volunteer will reach out manually. An e-mail should be sent when this happens using the built in spoke e-mail mechanism. (It should act similar to how text reply's currently email volunteers.) Optionally: It would be great to be able to log this info to a google sheet as well.

This is just me taking a very limited stab at guessing; but I believe this would be the function that you want to look at that handles incoming text messages from twilio(correct me in i'm wrong...); https://github.com/checkuponme/Spoke/blob/master/src/server/api/lib/twilio.js#L348-L383