Playable's gamification system allows marketers to create, tailor and deploy marketing gamification campaigns / competitions to deliver results at every touch-point. Here you can learn about the Playable integration with Voyado Engage.

The integration offers the following features:

1. Sign up Playable customers to Engage
   Once you enter a competition and sign up for it for, Playable will check if the customer already exists as a contact in Engage. If not, Playable will create them there. If the customer already exists in Engage, Playable will just update the contact with data from the competition.
2. Enrich a customer's profile from Playable
   You can ask customers for custom attributes such as interests, favorites and so on in Playable and send this data to Engage to be saved for the contact there.
3. Custom Trigger in Engage
   You can trigger automation flows in Engage from Playable, including with personalization, once a customer has completed a campaign / competition. An Engage custom trigger will need to be created for each one (or you can even have several triggers each one). This can be done through the Configure Engage area. The trigger IDs used needs to be communicated to Playable.
4. Build automation flows around game outcomes through Interactions
   You can build automation flows around certain specific games, certain outcomes of a game you have enrolled in or maybe award customers with points dependent on how many games they have played. 

Example

If the customer does not exist in Engage, they can be created using this endpoint:

POST /api/v2/contacts

Using a payload like this:

{
  "firstName": "John",
  "email": "john.doe@voyado.com",
  "mobilePhone": "4237",
  "campaignSource": "Playable",
  "country": "Danmark",
  "source": "Playable",
  "storeExternalId": "1",
  "contactType": "Member",
  "preferences": {
    "acceptsEmail": true,
    "acceptsSms": true
  }

This request will return the contactId value that uniquely identifies this contact. Read more about contactId and how to work with it here. 

An update to the contacts information (enrichment) can then be made to Engage like this:

POST /api/v2/contacts/{contactId}

And for an update, use this kind of payload. Note the differences in how the preferences such as acceptsEmail and acceptsSms are handled here:

{
  "firstName": "John",
  "email": "john.doe@voyado.com",
  "mobilePhone": "345",
  "acceptsEmail": true,
  "acceptsSms": true,
  "campaignSource": "Playable",
  "country": "Danmark",
  "source": "Playable",
  "storeExternalId": "1"
}

The Custom trigger ("proPlayable" in this case) used when the competition is completed for a particular contact looks like this:

  POST api/v2/automation/customTriggers/proPlayable/triggerByContactId/{{contactId}}

No payload body is needed in this request.

Read more about the Engage integration with Playable on their site.

Article last reviewed 16 July 2025 11:14