Separate aggregation and Ona modules to send data to another service at the end of a botkit flow

[pld]

1. Write a module that aggregates data

When a flow ends, we want a module to group all the data collected in the flow together, including:

• all questions and answers (including questions from button clicks)
• information on the contact to uniquely link them back to RapidPro
• meta data about the conversation:
  • an identifier for the bot that this data came from
  • the start time of the conversation
  • the end time of the conversation
  • metadatalog (all the other metadata so we can parse it later if we need to)

2. Write a module that stores this data in Ona

Decoupled from the module that aggregates data, write a module that stores this data in Ona, can use the milia (and if we stick in JS for now the JS link to milia, @royrutto and @geoffreymuchai have used this)

• take's a datasets ID, we'll assume we the structure of the dataset match the data we're putting into it
• user credentials

[urbanslug]

How to do this: 1.

• [x] Write a separate data aggregation module.
• [x] GET the user profile from FB. https://developers.facebook.com/docs/messenger-platform/user-profile
• [x] Write a function in the data aggregation module to merge the following into a single key/value structure for a user profile:
  • facebook messenger ID
  • first_name
  • last_name
  • profile_pic
  • locale
  • timezone
  • gender
  • is_payment_enabled
  • last_ad_referral
• [x] Write a function in the data aggregation module to extract:
  • start time of the conversation
  • end time of the conversation
  • responses and questions
  • the whole metadata key-value structure
  • bot identifier i.e conversation.context

    {context: { user: '1443686282372521',
    channel: '1443686282372521',
    bot:
    { type: 'fb',
    botkit: [Object],
    config: {},
    utterances: [Object],
    startConversation: [Function],
    createConversation: [Function],
    send: [Function],
    startTyping: [Function],
    stopTyping: [Function],
    replyWithTyping: [Function],
    reply: [Function],
    findConversation: [Function],
    say: [Function]
    } 
    }
    }

2.

• [x] Write a function to POST the contact info/user profile to rapidpro

An example facebook profile from FB looks like so

{ first_name: 'Bots',
  last_name: 'Maker',
  profile_pic: 'https://scontent.xx.fbcdn.net/v/t1.0-1/17426114_114715302399085_9126504909207438629_n.jpg?oh=ac5699635c68bccd07dc908b9dc93a03&oe=597A2513',
  locale: 'en_GB',
  timezone: 3,
  gender: 'female',
  is_payment_enabled: true}

We plan to POST to rapidpro JSON that looks like this:

'{
    "name": "Initial Contact",
    "urns": ["facebook:2334445454"],
    "fields": { "profile_pic": "https://scontent.xx.fbcdn.net/v/t1.0-1/17426114_114715302399085_9126504909207438629_n.jpg?oh=ac5699635c68bccd07dc908b9dc93a03&oe=597A2513",
                "locale": "en_GB",
                "timezone": 3,
                "gender": "female",
                "is_payment_enabled": true}
}'

3.

• [x] Write a node package wrapper for milia.

4.

• [x] Author an XLSForm that coincides with the questions and upload it to Ona
• [x] Write a Karma function to POST a submission to Ona at the end of a conversation.
• [x] Successfully make Karma submission to Ona.