Skip to content
Rafael edited this page Apr 19, 2018 · 24 revisions

Gambit Campaigns provides three resources:

  • GET /v1/campaigns - lists all Campaigns that have keywords published
  • GET /v1/campaigns/:id - lists all templates for a specific Campaign conversation
  • POST /v1/campaignActivity - saves inbound Gambit Conversations messages as Rogue Signups and Posts
  • POST /v1/receive-message[DEPRECATED] - saves inbound Gambit Conversations messages as Rogue Signups and Posts

Campaign conversations

Gambit Conversations posts to the Gambit Campaigns POST /v1/campaignActivity endpoint when it's determined that an inbound message should be parsed for Campaign Signup data.

Required Params
campaignId
campaignRunId
platform
postType
userId

For each POST /v1/campaignActivity request, Gambit Campaigns integrates with Rogue to check:

photo postType

  • Does a Signup exist for this User and Campaign?

    • If NO - Create Signup, and reply to User with startPhotoPost template, which prompts User to text START once they've completed the Campaign.

    • IF YES - does a draft Reportback Submission exist for the Signup?

      • If YES - proceed to next check
      • If NO: Did user text START command?
        • If YES - create a draft Reportback Submission for the Signup and reply to User with askQuantity template.
        • If NO - reply to User with startPhotoPostAutoReply, which prompts them to text START.
  • Does the draft Submission contain a quantity?

    • If NO - reply to User with askQuantity template
  • Does the draft Submission contain a photo?

    • If NO - reply to User with askPhoto template
  • Does the draft Submission contain a caption?

    • If NO - reply to User with askCaption template
  • Is this the User's first Post for the Campaign?

    • If YES - reply to User with askWhyParticipated template. When user responds with why they participated, post the submission to Rogue as the first Post for the Signup.
    • If NO - post the submission to Rogue as another Post for the Signup. The why_participated property is only collected on the User's first Post for the Signup.

Links

Clone this wiki locally