API & Webhooks | Community
Skip to main content

API & Webhooks

Get more out of Intercom using our API and webhooks

  • 553 Topics
  • 1,268 Replies
553 Topics
D
Dmytro HorodetskyiNew Participant
asked in API & Webhooks
Is the updated_at field equal to the created_at field at the conversation/contact creation?

I want to search and load only new conversations/contacts.By “new” I mean newly created and updated ones.Can I do it only by updated_at field? For example, if the contact is created on 15.11.2023 18:00:00, will the updated_at field be the same? So I do not need to add the created_at field alsoSo if we assume the time boundaries are 06.11.2023 00:00:00 and 12.11.2023 00:00:00, then what I expect to see is:contacts that are created in this period AND contacts that are updated in this period (irrelevant of the fact when they were created)

922
D
T
Timothy OngNew Participant
asked in API & Webhooks
react-use-intercom useIntercom() onHide() not working?

const onHide = () => console.log("Intercom did hide the Messenger"); return ( <IntercomProvider appId={process.env.REACT_APP_INTERCOM_APP_ID || ""} initializeDelay={1000} onHide={onHide} > {children} </IntercomProvider> );I have this line of code, when i press the X button on my intercom widget to close it, i do not get the onHide console.log. Anyone knows how to fix this?

3611
Jacob Cox
Intercom Team
K
Kevin D13Connector
asked in API & Webhooks
Salesforce Community Lightning Component

Hi Community,Does anyone have experience with building Lightning Components for Intercom? We want to add a button to our Salesforce Community that says, “start a live chat” and when clicked, it uses the Intercom JS API to open the messenger - https://developers.intercom.com/installing-intercom/web/methods/The challenge we’re having is we don’t know how to build a lightning component that will work in our Salesforce community that calls the Intercom JS API.Best,Kevin

3672
Jacob Cox
Intercom Team
A
aviploNew Participant
asked in API & Webhooks
Conversation webhook

During my research within the API documentation,I encountered a challenge in identifying a method to establish a webhook for the purpose of receiving notifications when a message is received by the agent.I am inquiring whether such a webhook functionality is available within the provided resources.

1981
Jacob Cox
Intercom Team
D
dilara.murathanogluNew Participant
asked in API & Webhooks
Retrieving 25K conversations via the API - Help!

Hello,We are working on conversation export via the API for 25K conversations.The first step, listing the conversations via the API is completed.Could you recommend a practical way for the second step - retrieving the conversations?Because it is very challenging to retrieve each conversation one by one and we are on a very tight schedule.Does anyone has experience with coding to retrieve the conversations in bulk and automatically in a quick manner?Any suggestions related to coding or any other options that will achieve our goal will be highly appreciated.Thanks. 

401
Eden
Employee
J
Janet CarolanNew Participant
asked in API & Webhooks
Webhook is triggered multiple times when it shouldn't be

Can’t work out why my intercom series is triggering 4 webhook triggers (n8n executions) for the same payload/customer (user a)series:n8n executions : bare in mind the final merge2 in n8n waits for both inputs then sends slack message.all nodes set to execute once.in the left panel you can see the webhook was triggered 8.11, 8.14, 8.16, 8.21 am intercom webhook block statsuser a should only have triggered the webhook once 

1921
Racheal
Intercom Team
Z
zwinansNew Participant
asked in API & Webhooks
Activity log for specific agents

Hello!Is it possible to use the activity log endpoint to query results for a specific admin rather than having to sift through all admins? 

981
Racheal
Intercom Team
S
Spencer HawkinsNew Participant
asked in API & Webhooks
Tickets and Conversations

Hello 🖐 I’m working on building a chat application where customers in group chats can purchase items from inside the chat. I’m designing this in a way that uses APIs and Webhooks. I’ve been spending the last few days reading over the API documentation and am still uncertain about what best practices are regarding tickets and conversations. I know that I’ll need to open a conversation for my customers to be able to speak to support. Is it standard practice to open a ticket each time the conversation is opened? Also, from my understanding tickets can be converted into a conversation but there is no standard way to track tickets with conversations. Any insights would be greatly appreciated

9281
Jacob Cox
Intercom Team
Y
yehoshooa friedNew Participant
asked in API & Webhooks
Creating an Add-On for Intercom Call Routing

I'm interested in developing an add-on for our telephone representative service that would allow other companies using Intercom to route their calls through us. How can I get started with this integration, and what resources or documentation should I be aware of in order to make it happen?

612
Y
H
Harleigh ShepherdNew Participant
asked in API & Webhooks
Access logging for API activity

Hi thereIs it possible to view a log of API activity, similar to the Teammate Activity Log, but for any changes or activities carried out via API? We are specifically interested in identifying any User updates or Users created via the API endpoint.Many thanksHarleigh

3333
Jacob Cox
Intercom Team
D
Dmytro HorodetskyiNew Participant
asked in API & Webhooks
Get only specific fields via request

Hi! My question is, can we get only specific fields while making a request to intercom API? What I mean is can we somehow mention that we need only one or a couple of fields? For example by adding “&fields=type, total_count” to the request URI for getting conversations. Getting all fields for all conversations is just absolutely not optimal, especially considering the body part of the conversation. Moreover, the more conversations we will get, the heavier each update of this date will be. 

1482
D
S
Slaysi AdminNew Participant
asked in API & Webhooks
Multiple device with the same Account

Hi everyone, in my web app, my user can login in multiple device with the same Account, but in every device have its own device conversation.Can i sync that into one ? For example expected:  - Account A device 1 → Start conversation X - Account A device 2 → Start conversation Y=> Both device will get conversation X and Y

5951
Eden
Employee
K
koheiNew Participant
asked in API & Webhooks
user_hash looks fine, but intercom is not showing up with a 403 error.

Hi,I have embedded the Intercom script using Javascript. When I checked the Intercom setting configuration, everything looked good to me. But when I tried to init Intercom messager, I got an error "Invalid user_hash". Then I tried to check the user_hash value in the setting and compare it to the value in the dashboard. It's all the SAME. Why I still got this error?  

1932
F
A
AndyRNew Participant
asked in API & Webhooks
Sample registration process

Hi, guys!I would like to create a "step-by-step registration" process. I may be a little vague in my explanations, but here is the sample algorithm of the future process.On the site there is a minimalist form for new clients. I want to redirect this flow directly to Intercom, where Leads will be created. Here I will use Intercom API on the Python backend. Data received from the form, as well as additional information collected on the backend and saved in Intercom, are reviewed by a specially appointed manager. Let's assume that the result of his review fits into 4-5 actions that he chooses (where? and how?) to continue registration. In case of, say, refusal, the manager writes (selects the appropriate one from the already predefined - ?) message in the dialogue. If, for example, negotiations begin, then the dialogue with the Lead also continues. It is possible to exchange some files or screenshots. Here I would also like to automate the manager’s actions as much as possible. If the neg

1692
A
C
CallLoop SupportNew Participant
asked in API & Webhooks
Block contact via API?

How can we block a contact via API? I don’t see it, only Archive, but we need the ability to block spammers entirely. 

931
Shauna
Intercom Team
Z
zwinansNew Participant
asked in API & Webhooks
Endpoint for activity logs for support agents?

Hi there,I’m looking for an endpoint similar to the List all activity logs endpoint but for support agents rather than solely admins. Is there anything like this currently available? 

531
Eden
Employee
D
degraffNew Participant
asked in API & Webhooks
Agent Status pulled from API

How would I be able to send real time agent status to our WFM platform? They can set up an integration via API or database ODBC. For this specific use case we need the current agent status sent over so we can compare their status to their scheduled activity.

1632
D
U
Uttam ChoudharyNew Participant
asked in API & Webhooks
Can I Specify event_name for webhook topic 'event.created'?

Webhook event topic https://developers.intercom.com/docs/references/webhooks/webhook-models/#event-topics covers a lot of events like lead generation, user events etc.I want to subscribe the topic only for Survey events(NPS or any other custom survey).Question is how can I specify event_name for surveys or is there any other way to subscribe for survey events?

473
Jacob Cox
Intercom Team
D
david meakinActive User
asked in API & Webhooks
webhook error

Hi Im trying to create a webhook to stream some data to power bi. It seems pretty straightforward, but every time I enter the URL provided by power bi I get an error when I save.Is anyone familiar with webhooks and would know why I might be getting an error. This is the URL i’m trying to post data too.https://api.powerbi.com/beta/f4d47d75-31cd-49f6-9e40-9e32fbc4be60/datasets/c8b21055-b5c1-48e7-a3ee-fbe0b54a0b19/rows?experience=power-bi&key=GoCdtgSEk64pdsEadmz3Pe52aqKPrUSyeQewkcjSfSz9nrldMbcfntQPtmlvcZNHbF%2Fb4x8A9xESCHvmOw%2BZig%3D%3D

2913
Diana Tripac
Intercom Team
U
User1559New Participant
asked in API & Webhooks
Checklist Step Level Analysis

Hey ,Whats the best way to programmatically export checklist step level data from the API?I'm able to get the overall numbers. But struggling to find the numbers that will give me step level data

1295
L
A
Arav ManaktalaNew Participant
asked in API & Webhooks
Different responses for Search and List API in conversations

We are getting inconsistent responses on tags from different intercom API calls for conversations. For search API with high date range we are getting lesser tags as compared to actual tags. While using list API we are getting the correct and consistent results. Is this behaviour expected or should we do something differently ?

461
aykut.aydin
Employee
S
somesh1833New Participant
asked in API & Webhooks
How can I retrieve Contacts and Conversations data by specifying a date using a REST API?

How can I retrieve Contacts, Conversations and Ticket data by specifying a date using a REST API? Could you provide the URL for this operation?

1131
Jacob Cox
Intercom Team
U
User876New Participant
asked in API & Webhooks
Get converstion ID from message ID

When I create an admin initiated message from API https://developers.intercom.com/intercom-api-reference/reference#admin-initiated-conversationI get no conversation_id in response. Then, I cannot find this conversation or refer to it somehow. Although in contact's profile this message belongs to conversation with an id! So, what I'm trying to achieve is to send a message to contact through API and then be able to save a link to this message.

2952
K
D
Dmitrii SablinNew Participant
asked in API & Webhooks
Get live messages via API or webhook

Is there any option to get event about Post (message anouncement for instance) has been created / setted as “live” ? via API for example? before user received it

601
Jacob Cox
Intercom Team
R
Renz SanchezNew Participant
asked in API & Webhooks
Retrieving conversations based on company id when multiple contacts can be part of different companies

In our company, we’re trying to retrieve recent conversations per company. I’ve tried the approach of another question posted in the forums. The problem is contacts can be part of multiple companies and when I run the query, the conversations from other companies are showing up as well. Anyway to do this?

631
Eden
Employee
Ask a question
Terms & Conditions