API & Webhooks

I know I can get the entire conversation which contains a list of all the conversation parts but that's overkill for my needs. I have a workflow automation tool that needs to check whether a particular conversation part has already been redacted and would like to get right to that data.

Essentially I have a production workspace and an app linked to it based off the 1.0 API version. I would like to make another app with the latest API version and more permissions and use it to retrieve the data from the same workspace. Will installing this app on the existing workspace break the other app or the workspace itself?

Hey there, I want to pass arbitrary data as custom_attributes to conversations. The update conversation endpoint succeeds but the data is not returned from the retrieve endpoint. Do you know why? Is this property working and if how? Is arbitrary data even allowed or do I have to define this data upfront?

How to send a message through the api to receive a reply from the robot

I am hitting the articles API and it returns the parent id for each article. Here is the article:https://support.tulip.co/en/articles/2280642-how-to-run-an-app-in-the-tulip-player/p>and its parent is:https://support.tulip.co/en/collections/2983157-introduction-getting-started-with-tulip#general-guides/p>which has an ID of 2983157, but when I call that document from the api I get a parent id of 3463139, which isnt a section or collection in my workspace.  Any idea what could be causing this? Pete

Hi, I'm building a custom support page listing articles using API. I saw a report called "Article engagement" with some statistics like "Views", "Conversations" and "Reactions". Is it possible to implement these statistics with API?

Apparently when I do a request for /search endpoints that has many results I receive the HTTP error 429.. e.g:body = { "query": {"field": "updated_at", "operator": ">", "value": 1656362751}, "sort": {"field": "updated_at", "order": "ascending"}, "pagination": {"per_page": 150,}, }   response = request.post(endpoint="https://api.intercom.io/conversations/searchquot;, payload=body)Even if it's only one day of search it leads to that 429 error...

Dear friends,  Do you guys know how can I connect my Intercom data into my MS Powerbi? I've searched and it looks like it is possible to get this done using the rest APIs provided by the Intercom but I'm not managing to access them, can someone help me on this?  Kind regards,

Hello, I am trying to merge contacts leads into users as follow: curl --location --request POST 'https://api.intercom.io/contacts/merge#39; \--header 'Authorization: Bearer toto=' \--header 'Content-Type: application/json' \--header 'Accept: application/json' \--data-raw '{  "from": "623f6320f06ce936269f7bd9",  "to": "6189c5687f416a8308a57a23"}'When I try and query for them individually like this: curl --location --request GET 'https://api.intercom.io/contacts/623f6320f06ce936269f7bd9#39; \--header 'Authorization: Bearer toto=' \--header 'Content-Type: application/json' \--header 'Accept: application/json'

In my current integration, I made an assumption that if a contact was created and associated to a company that contact's company details would come in on the `contact.created` webhook notification. However, I'm no longer convinced that this is ever the case as I see the creation of a contact and attaching it to a company are always done in 2 separate requests in the UI or via API. Is there ever a case where the `contact.created` notification would contain the contact's company details? I haven't been able to make it work even making the attach to company API request in quick succession after creating a contact.  Are there other webhook notifications we could use to know when the contact becomes attached to a company or any other alternative approaches we could use besides polling the contact for updates?

can I have an example !

I use @intercom/intercom-react-native. User is registered with Intercom.registerUnidentifiedUser() and I use Intercom.updateUser({ Tag: 'someTag' })but when I check user in Intercom I see Tag has not been set.

I'm trying to send a new message using "https://developers.intercom.com/intercom-api-reference/reference/admin-initiated-conversation" api and i'm sending `create_conversation_without_contact_reply` key as true in the payload but the response received doesn't contain any conversation_id in it as described in api_documentation. What i trying to do is to get the conversation_id and then instead of sending a new message every time, Send a message as reply to this conversation.Am i missing something here? Or is there any work around available to handle my scenario?

Usecase: We have a requirement to create an canvas app and serve it through an API. I could create an app and also serve it through conversation message from Agent view but I am not quite sure how to send it through API. When I intercept intercom UI (Through network monitor) and how it sends app in conversation it does three things Configures the card Initializes the cardSends the card in conversation {"app_id":"----","conversation_id":"15","blocks":[{"type":"messengerCard","canvas":{"id":"-----" Is there any way to do the same thing using API?

Hi,For create_message and create_conversation have same error. create_message_url = "https://api.intercom.io/messagesquot;create_conversation_url = "https://api.intercom.io/conversationsquot; create_message:{"type":"error.list","request_id":"0000gs3ckh0kbkfn1i4g","errors":[{"code":"server_error","message":"Server Error"}]} create_conversation:{"type":"error.list","request_id":"00b89n0esi3jhj96s2og","errors":[{"code":"server_error","message":"Server Error"}]} Thanks for helping.

Hello, We are using messages API "https://api.intercom.io/messagesquot; to send emails to intercom users from our website.We are trying to send email with HTML but look like API don't support for HTML version. So We have created custom templates into intercom system.  Right now we are looking for to send emails with custom templates, please let us know how we can send emails with template from API. Thanks

I saw another question here, and the answer was referring to tags, but I would like to update the title field of the conversation via API, the update endpoint doesn't seem to work for that.

Since we migrated directly to intercom, there is no phone number attribute, there is a Whatsapp Number attribute on the intercom website but when we use the contact or conversation apis, we are unable to get the Whatsapp Number. How can we get the Whatsapp Number using contact ID ?

Hello!I am trying to create a conversation from a visitor per the doc: https://developers.intercom.com/intercom-api-reference/reference/create-a-conversation I've tried setting `type` to `contact` as indicated. When passing a `user_id` like so: { "from": { "type": "contact", "user_id": "1234567" }, "body": "Hey"} I received the error `Lead Not Found` and the conversation / contact with role lead are not created as expected. How can I create conversations from visitors? Additionally, in an ideal world I would be able to pass a singular user ID (not knowing if this is a visitor or existing

In the API doc: https://developers.intercom.com/intercom-api-reference/reference/conversation-model/p> admin_assignee_id is mentioned as type string, but on api calling it is coming as integer. 

Hi, I am getting a "user not found" reply from the API however the user ID is correct AND existing.I am wondering what could be wrong as I am using the access token that is referenced in our account... any help

When attaching a tag to a conversation, they do not always appear in the conversation view. They do, however, appear against the conversation when retrieved via the API. What can I do to mitigate this and ensure the tag always shows in the conversation? My workflow (simplified), using the node intercom client, is: - await conversation creation- await attachment of one or more tags Intercom client always responds successfully, however, it appears there is some internal intercom mechanism to associate a tag with a conversation part, and that perhaps there is a race condition between the part becoming available and the tag being attached. When I retrieve the conversation from the API, i can see that the tags are attached to the conversation.

Is there a list anywhere of what token errors mean? We're getting this reply for one of our customers:{"type":"error.list","request_id":"002qgl7rvpn5e8fi3vf0","errors":[{"code":"token_suspended","message":"Unauthorized token, suspended application"}]}And we're not sure if 'suspended application' refers to us, or the customer's account.

Hello, Using v2.4 of the API. We have a webhook on 'conversation.admin.closed', that return a conversation-ish object. Some fields from the documentation are not there (like 'contacts' or 'source') and we have extra fields (like an 'assignee' object). This documentation seems to says that it's a "Conversation data", but what we get do not match the conversation model. Is this realy a conversation model or something else ? Where can I find the documentation for this ? Example of data we

I installed the messenger to our site via GTM per these instructions. It works as expected however our Engineer noticed the script is having a negative impact on our page load times.  The article recommends using "Window Loaded" as the trigger, but I'm wondering if anyone knows of any different triggers that could be used to delay the script from loading until after the main elements on the page. I see GTM has options for Timer based or Scroll triggers and thought these looked promising.  Anyone have any input or recommendations here? Thanks