Skip to main content

Hi, I have been trying to create our own intercom that interfaces to our own internal api to provide user details and properties. But how do I get the information around the context/lead in the initialize request. I have been trying to follow the tutorial and understand how I display components in the Canvas Kit, but how can I understand the context/lead of the user that is access when this app is shown in the conversation window?

Hi @thomas n13​,

 

When you provide a URL served by your app, Intercom will call it with a POST method:

config_urlThey provide the context with their POST request. In an app for Users, here is an example of data posted by Intercom to an Initialize flow webhook URL:

{

"workspace_id": "XXXXXXX",

"context": {

"conversation_id": XXXXXXXXXXXX,

"locale": "en",

"location": "conversation",

"messenger_action_color": "#333333",

"messenger_background_color": "#333333"

},

"admin": {

"type": "admin",

"id": "XXXXXXX",

"name": "XXXXXXXXXXXX (my name)",

"email": "my_name@domain.com",

"away_mode_enabled": false,

"away_mode_reassign": false,

"has_inbox_seat": true,

"avatar": {

"image_url": "https://static.intercomassets.com/avatars/XXXXXXXXXXXXquot;

},

"team_ids": ;]

}

}

In an app for Teammates, here is an example of data posted by Intercom to an Initialize flow webhook URL:

{

"workspace_id": "XXXXXXX",

"admin": {

"type": "admin",

"id": "XXXXXXX",

"name": "XXXXXXXXXXXX (my name)",

"email": "my_name@domain.com",

"away_mode_enabled": false,

"away_mode_reassign": false,

"has_inbox_seat": true,

"avatar": {

"image_url": "https://static.intercomassets.com/avatars/XXXXXXXXXXXXquot;

},

"team_ids": ;]

},

"conversation": {

"type": "conversation",

"id": "XXXXXXXXXXXXXXXXXXX",

"created_at": 1633532241,

"updated_at": 1636364551,

"waiting_since": null,

"snoozed_until": null,

"source": {

"type": "conversation",

"id": "XXXXXXXX",

"delivered_as": "customer_initiated",

"subject": "",

"body": "\u003cp\u003eHello!\u003c/p\u003e",

"author": {

"type": "user",

"id": "XXXXXXXXXXXXXXXXXXXX",

"name": "XXXXXXXXXXXX (customer's name)",

"email": "my_customer@domain.com"

},

"attachments": 😉,

"url": "XXXXXXXXXXXX",

"redacted": false

},

"contacts": {

"type": "contact.list",

"contacts": ;{ "type": "contact", "id": "XXXXXXXXXXXXXXXXXXXX" }]

},

...]

}

}

More about this here: https://developers.intercom.com/building-apps/docs/canvas-kit#section-requests-responses/p>

 

Hope this helps!

Reply


Terms & ConditionsCookie settings