API & Webhooks

API Get specific tag of specific conversation

Hello Currently, I use the Retrieve a Conversation API to get conversation details.https://developers.intercom.com/docs/references/2.7/rest-api/api.intercom.io/conversations/retrieveconversation This API returns a list of tags associated with the conversation, but it doesn't include information about which specific tag belongs to which conversation part. Could you please advise on how to determine which tag belongs to which conversation part? Thanks.

Is there a way to filter or sort events in the lisdataevents API?

Hello, everyone! I'm working on building reports in Power BI, and I'm extracting data via the API for that purpose. The data-events API is a bit slow due to the amount of events and it’s making the extraction difficult. Is there any way to filter or sort the events?

Looking for possible values of `` conversation `"part_type" property

Hello, I’ve found this page about possible values of conversation’s “part_type” property https://developers.intercom.com/docs/references/1.4/rest-api/conversations/conversation-part-model#conversation-part-types but it’s missing for current API versions and this list is definitely not complete (e.g. I don’t see there ‘channel_and_reply_time_expectation’ part_type) Is somewhere available a full list of possible `part_type` values ? I have an integration with Intercom and want to filter out “useless” messages for me when syncing, e.g. messages from operator to the user Thank you in advance.

Leveraging the Shopify Order Lookup Feature To Show Custom Attributes

Hey everyone - Excited to get rolling with Intercom. We’ve chosen this platform over others specifically because the API access it offers to allow us to show custom attributes - like Estimated Shipping Date. Gorgias and others can’t do this yet (apparently). The use case is simple. A customer hits the chat and asks “What Is My Estimated Shipping Date”, we respond asking for an Order Number. We use this order number to search the Shopify API, pull back the order details, which includes a custom metafield called estimated_ship_date. We then show that data to the customer. I’m sure I can do all this with numerous actions. But it seems to me that using the out of the box Order Search as a starting point would be best. I can then access the order.id and do 1 very specific call to pull back metaafields. My question at this point is … can we use the Order Status feature as a starting point for an automated workflow? If not … does my workflow above make the most sense? Thanks! kane

Golang custom event rich link

I am trying to send a rich link in the metadata of a custom event triggered with the intercom-go package. In intercom’s dashboard, it reaches as [Object Object]. Is there any different input format expected for rich links in go, or is it just not supported? event := intercomlib.Event{ UserID: userId, EventName: eventName, CreatedAt: int64(time.Now().Unix()), Metadata: map[string]any{ some_rich_link: map[string]any{ "url": "https://www.some-custom-url.com", "value": "some-custom-name", }, }, } ic.Events.Save(&event)

Unable to create conversation reply using admin id

I kept getting the following error when trying to reply to a whatsapp message using an admin type with the admin_id retrieved from the admin endpoint { "type": "error.list", "request_id": "003ririmu25u6re52260", "errors": [ { "code": "not_found", "message": "User Not Found" } ]}

Webhook notifications are not delivered for conversation.admin.replied

Hello, I have configured Intercom Webhooks because I wanted to receive notifications about admins replies. I’ve set Endpoint URL and subscribed to “conversation.admin.replied” topic.The endpoint URL is correct and valid, because I received some initial requests (including PING). It also receives a request every time I click “Send a test request” in config page. The problem is that I don’t get any notifications about admin replies. I have logged into Intercom as an admin, I have replied to an user – and nothing happened. There are many users using our Intercom everyday and at least a few times a day one of the admins replies – so I suppose there should be some notifications coming to my webhook. Unfortunately, that’s not the case – it seems like I’m receiving 0 requests from Intercom Webhooks. Can you help? Can you point me what may I be doing wrong?

Can I create a webhook for team member mentions in conversations?

Is there a way to create a webhook to fire whenever someone mentions another (specific) team member ? My end goal is to receive a direct message in my Slack whenever someone mentions me in Intercom Thanks!

Can I tag user when creating a note from the API?

While creating note from the intercom interface I can tag teammates, can i do that with the API?

Why in custom actions, the request to the API endpoint is not triggered when last name is missing?

I have a custom action which is executed at the end of a custom bot flow. It sends a Post Request to an API endpoint with the details above. If the user inputs only first name, e.g. “Andrew” in the “Full Name” field then the API call is never triggered. Any solution for this? or is there a way to validate the “Full Name” field and ask the user to also input their last name? Thanks

API for setting 'Replied STOP. Filtered by carrier' for a contact

Hi, is it possible to set a contact's default SMS to "Replied STOP. Filtered by carrier" using an API? And listen for changes to SMS settings via webhook. Thanks

Single language translation deletions in articles

Is it possible to delete only a specific language from the translated content of an article with the API?

Creating news item via API and adding to the news center

I’m able to create news items via API and assign to the correct news feed, but is there a way to add them to the news center? When creating a news item through Intercom’s interface, there is an option to show a badge on the launcher, which corresponds to the “deliver_silently” property, and there is an option to add to the news center. That news center option doesn’t have a property that I can find in the API documentation. Is it possible to add the created news item to the news center via API, or would I still be required to use the interface to do this?

Darshan Hiranandani : How can I obtain a full export of my articles and helpdesk inbox messages with their text?

Hi Team, I’m Darshan Hiranandani, looking to obtain a full export of my articles and helpdesk inbox messages, including all their text. Could anyone provide suggestions or guidance on how to achieve this? Your insights would be greatly appreciated! Thanks, Darshan Hiranandani

Intercom Reporting Metrics - Looking for how metrics are calculated

Hello, We would like to pull the following Intercom Reporting Metrics via the API. We are looking at the documentation here https://developers.intercom.com/docs/references/rest-api/api.intercom.io/conversations/conversation. That being said, we are having a hard time matching the following. Please let us know if there is documentation on how to pull the metrics listed below. Time to Close - Bot inbox time included First response time, excluding bot inbox time and within office hours Replies per conversation CSAT score Conversations openNew Tickets

Compatibility of Using Different API Versions for User/Contact Management

In the "Developer Hub" section, we have set up the API version "1.4", this version is used in all our clients. In the old API versions (for example, in 1.4), there is a method "Create or Update User". In the new API versions (for example, 2.11), the endpoint "api.intercom.io/users" is not described, but there is a Contacts documentation section, which describes similar methods. Can we simultaneously use the old API version 1.4 for user management (through calls to "api.intercom.io/users") and the new API version 2.11 (through calls to "api.intercom.io/contacts"). For calls to the new Contacts API, we plan to use the HTTP header 'Intercom-Version': '2.11'. Will such use of two different API versions break the logic of Intercom, will user/contact data be lost?

Darshan Hiranandani : How do I extract data from my workspace and upload it to another system?

Hi Team, I’m working on a task that involves extracting data from my workspace and uploading it to another system. I’d greatly appreciate any detailed suggestions or best practices you might have for this process. Best regards, Darshan Hiranandani

API for fetching all users - not just admins

Hello, I reviewed the API documentation and noticed that there are only APIs for Admin users. Is there an API for fetching all users; admins and non-admin alike? Thanks in advance,

Error "Query body must contain a query hash" when searching conversations (part 2)

Hi, I had opened a ticket which was flagged as solved, but it’s not solved. I’m trying to use a snippet code i got from your developer website, to search conversations between two epochs. The codes runs without a problem on your platform, but when I use it in google scripts I get the response: {"code":"invalid_query","message":"Query body must contain a query hash"} I guess it is related to the JSON payload, though the string seems to be ok. I was able to work with the API without any problem, when I don’t send a body, but I always get the error whenever I include a body. I do have the ‘application/json’ in the code (the snipped below was copied directly) and I’ve tested removing the apostrophes from ‘content-type’ and I still get the same error. I’m adding a screenshot of the data structure in my memory. All looks as it should. Any clue? const str = JSON.stringify({ query: { value: [ {field: 'created_at', operator: '>', value: '1690081199'}, {field: 'created_at', operator: '<', value:

Insert article into message through api

Is there any way to insert articles into messages using the api or sdk?

Is it possible to make viewable "Help" section in Telegram?

Is it possible to share prepared articles from the "Help" section in the Intercom chat on Telegram and WhatsApp using a chat bot? I am not looking for pre-made solutions available on the internet, but rather want to know whether such functionality is available. For example, if a customer contacts support via Telegram and we send them a pre-prepared article from the Help section, is it possible for the customer to view it? Since articles from this section are not sent in text form, but instead through pop-up windows with hyperlinks, is there any way to make this information accessible to the customer?

A certain API request is returning a 401 (the others work)

Hi, I am using Make (formerly Integromat) to automate data exports. So I’m following this API call in the documentation : https://developers.intercom.com/intercom-api-reference/reference/create-data-export To do so in Make, I use the Intercom module “Make an API call” with a POST request (see attached picture) with the right URL endpoint : /export/content/data. (as mentioned in the doc) And with two dates with the right format in timestamp (I took June 1st and June 30th for the example). But when I try it I get a 401 error “unauthorized”. I don’t understand because in other automations I use the exact same module to Search contacts. In this case it is still a POST request and what changes are : the URL endpoint is : /contacts/search And the parameters of the query but it works. I don’t understand what’s going on and overall : I don’t know how to get the authorization 😬 I tried to create another connection and to re-do the process to authorize Make to access Intercom and vice versa but

server error using convert conversation into ticket api

Hello, I’m new to the Intercom API and I encountered an error when using the “Convert a conversation to a ticket” api. The error is ‘errors': [{'code': 'server_error', 'message': 'Server Error'}] What should I do? Is there a solution for this problem?

Is it possible to trigger the creation of a ticket through the Intercom JS API?

Is it possible to get to this screen with the Intercom JS API?

Anyone else having issues with the Salesforce integration and FIN?

Hi! We’ve been having issues with our Salesforce Integration and FIN. We have our integration set up where FIN creates cases in Salesforce for each conversation, but that’s not happening anymore. We have already checked to make sure the mapping is correct and the conversations are with customers, not leads, nothing is working.