twilio Add a bulkSMS function to extend the twilio API

[taylordowns2000]

Currently, there's no simple way for a user to send SMSs in bulk via Twilio. In OpenFn, using the sendSMS function the code would be pretty darn clunky:

If we assume the initial state looks like this:

{
  "configuration": { ... },
  "data": {
    "recipients": [ 1, 2, 3, ... ]
  }
}

they could write something like:

each(
  dataPath('recipients'),
  sendSMS(state => state.data.recipients.map(r => ({
    body: 'blah blah blah',
    from: '+19148675309',
    to: r.phoneNumber  
  })))
);

but it's pretty clunky and we'd rather have a function which takes an array of objects with phone numbers and texts and attempts to enqueue an SMS to each of them, then reports back on the status of each in a user-friendly way.

I'd envision a signature like bulkSMS(from, template, toList) that automatically iterated through the toList array, maybe using some sort of template text. This is still nebulous, but I'm hoping that Gunjan might have some input on the desired signature and return here. An alternative to the above would be bulkSMS(messages) where each message in that messages array would need to contain from, to, and body keys. That might be the winner. 🤷

Take a look at how sendSMS is written for inspiration.