API & Webhooks

Get more out of Intercom using our API and webhooks

  • 367 Topics
  • 837 Replies

367 Topics

A
Angel AlagaoNew Participant
asked in API & Webhooks

Intercom React Native v4&5 issues on Android where the text input does not show up when opening chat and there is no close button

These are issues found on versions 4 and 5 of Intercom React Native https://github.com/intercom/intercom-react-native. On Android, when the Intercom.presentMessageComposer() method is called the text input does not show up. The user has no way to enter a message to interact with our support team.In addition, there is no longer a close button (‘x’) and the user cannot go back to our app the way they entered. Tapping the back button takes the user back to the intercom messages list and tapping it again logs them out of our app.Android: Text input does not show up and missing close button (‘x’)On iOS, when receiving Intercom notifications, and the app is backgrounded, tapping on an Intercom notification opens a new chat modal opens on top of the existing chat, causing a stack of modals to appear. The user needs to exit all the modals to access their previous screen.  

1
P
3 months ago
U
User2149Connector
asked in API & Webhooks

Custom Action to Zapier

Hi there,I would like to push full conversation body data via a custom action towards Zapier (webhook trigger).The reason why I would like to use custom actions is because I only want conversations that were initialized with a bot. The moment the conversation is assigned to the team, the custom action would send the full conversation to Zapier. In Zapier, I would then like to summarize the bot conversationd and post it as a note into the same message for the support agent to easily understand the conversation.The custom action I created seems to be successful, but the Webhook trigger in Zapier never receives the POST request from the custom action.Also, I don’t find a way how to get the whole conversation as data into JSON?I presume i need to use the “conversation_parts” object, but not sure how?Thanks in advance for the help!

1
Jacob Cox
4 months ago
D
Dev SinghNew Participant
asked in API & Webhooks

Unauthorized access with ruby client

I am trying to access contacts via the API using the ruby gem in a Ruby on Rails app. Have  a test workspace and have created an app in the developer portal in this workspace. Also generated an access token.I am able to create a client object in the rails console.However I get an authentication error when I try and make any calls to the api:[1] pry(main)> intercom = Intercom::Client.new(token: ENV['INTERCOM_TOKEN'], api_version: '2.9')=> #<Intercom::Client:0x0000000130716a48 @api_version="2.9", @base_url="https://api.intercom.io", @handle_rate_limit=false, @rate_limit_details={}, @timeouts={:open_timeout=>30, :read_timeout=>90}, @token="'***************************************">[2] pry(main)> intercom.contacts.find(id: '56f0399fc1f09a1bf6000200')Intercom::AuthenticationError: Unauthorizedfrom /Users/dsingh/.rbenv/versions/2.7.6/lib/ruby/gems/2.7.0/gems/intercom-4.2.1/lib/intercom/request.rb:164:in `raise_errors_on_failure'Is there some other configuration needed fo

1
Racheal
4 months ago
I
Ian LNew Participant
posted in API & Webhooks

Migrating Zendesk Tickets to Intercom

Hey there!We’re about to run a script on our side this week to migrate our historical Zendesk Ticket data to Intercom.Has anyone in the community had experience doing this?Curious to know how you prevent email notifications from going out to customers, and if its possible to backdate the conversations when you are creating them.Cheers,Ian

0
I
4 months ago
T
tuanna1601New Participant
asked in API & Webhooks

Await trackEvent

Hi, is there any way to wait until window.Intercom(‘trackEvent’) finishes? I’m tracking user’s logout event then use Intercom(‘shutdown’) to clean up the cookies and reset Intercom, but it always throws this error:Uncaught TypeError: Cannot read properties of undefined (reading 'then')    at frame-modern.422879eb.js:1:381486

2
T
4 months ago
P
PrajwalNew Participant
asked in API & Webhooks

Issue with creating new User from the java client throws NotFoundException

I’m using the 2.8.2 version of the app, I used the access token to connect to company account, but it seems like none of the api’s working, there was a thread on the scroll not working https://github.com/intercom/intercom-java/issues/185 but in my case the scroll api doesn’t seem to respond either as I get the same response “io.intercom.api.NotFoundException: The requested resource does not exist; check your path and try again”. did anyone run into similar issues? if yes how’d you solve it?

1
Jacob Cox
4 months ago
S
ssyam011New Participant
asked in API & Webhooks

Ticket Topic Webhook - Contact User Id value

We're checking the option to create a Case in Salesforce with the help of Webhooks Ticket Topic (Whenever a ticket is created in Intetcom, we defined a custom logic to create Case in SF based on webhook payload).One item that hinders our test is that in the webook Payload We're getting the alphanumeric Id (the one which appears in the user url) of the Contact. Instead we're expecting the 'User Id' value from contact (the 10 digit numeric Id) which we already added in SF contact. Any option to get that user id value in webhook tickets payload?

1
Milan
Top Expert
4 months ago
R
Rodislav ZaharadjiNew Participant
asked in API & Webhooks

Article sections not found via API

Hey, I’m trying to use the Article API but I got some problems when I get lists of collections, sections and when I try to match this with articles parent_id I have a structure like this:When I request the `help_center/collections` endpoint I receive 2 collections “Untitled collection” (id: 3941383) and “Example collection” (id: 3941384) Ok, now I get the list of sections `help_center/sections`I should get "Subcategory" and "Subsubcategory", but when I do this request I receive an empty list And now when I request the list of articles `articles` I get all articlesFor the article “Just another article” (id: 7228002) I get parrent_id: 3941386 and for “Test” (id: 7227829) I get parent_id 3941389 and parent_type: collection My question is,Where are my sections? Am I doing something wrong or is it a bug in the Intercom API?

3
V
4 months ago
G
Gianni D'AmicoNew Participant
asked in API & Webhooks

Discrepancies in Intercom API responses for Conversation data

Hello,I have noticed that the API does not return the same created_at value for Conversations when using API 1.3 compared to API 1.4 and later versions. The endpoint I am using is:https://api.intercom.io/conversations/{id}I noticed this when retrieving Intercom data via Segment.com, which apparently uses API v1.3, and Stitchdata.com, which uses API v2.5.To investigate this further, I tested the API request for the affected Conversations (which make up 10% of my total volume), and the dates returned changed when I incremented the API version used. Can you please explain what could be causing this? Were there changes in the API which I’m not aware of that could be affecting the results?Thank you for your assistance.

1
Racheal
4 months ago
M
Morteza JenabzadehNew Participant
asked in API & Webhooks

get a callback on intercom update

Hi We are facing an issue with intercom update .  after we fire this API a redirection happened sometimes we missed the API, after we add a delay (before redirection) it looks the problem solved but we can’t relay on delay. as i check the document i can’t see if this a async action. or if i can get a call back. So could someone please guid me how can we fix this problem?  Thanks in advance

1
Racheal
4 months ago
H
HaksNew Participant
asked in API & Webhooks

Is there a way to send company data in bulk?

Hi! We are using API method to update companies.However, these become thousands of discrete requests, is it possible for me to craft a payload containing all company data and send this in a single request? 

1
P
4 months ago
M
Mason DuttonNew Participant
asked in API & Webhooks

Resolution Bot Report via API

Are we able to request the data from the Resolution Bot Report via a reporting API of some kind?We want to be able to gather the table of data that compiles that report so that we can place it in a BI tool like Tableau for internal reporting purposes.Thank you!

2
M
4 months ago
U
User1329New Participant
asked in API & Webhooks

How do I merge leads and users? Having great difficulty doing this.

Hey y'all, I'm trying to merge leads into users but have difficulty getting this done. Here is my use case. I run an E-Commerce store; when customers check out, they do not always create an account or sign into an account to make a purchase. This is a guest purchase. But I want to ensure our support team can still have all their past information on hand. The way we have it set up now is through Zapier. When an order is created from WooCommerce, a user is created. This means that I now have a user with all the attributes of Name, Email and Phone. But at the same time this customer most probably has spoken to us through the messenger as well. Meaning we have a duplicated record. Our leads tend to have their Name, Email and Phone too. When a Lead makes a purchase, they should ideally be merged into the User. How can I get it done? Zapier doesn't have the function to convert a lead to a user, nor does it have a merge lead to user.  I saw on the forum that Make, formerly known a

2
T
4 months ago
L
Louis M
asked in API & Webhooks

Intercom API Contact Search Returns User Not Found

I am trying to search for a user based on an email using the v2.8 intercom API. If I retrieve a specific contact using this URL https://api.intercom.io/contacts/63e271ce28fe8babf612b417/code>I get the contact object as expected. If I then use the email of the response to search for that contact like sohttps://api.intercom.io/contacts/search/code>with this body{ "query": { "field": "email", "operator": "=", "value": "my email" } }I get the following response{ "type": "error.list", "request_id": "0000i0aso7mmifvpqc1g", "errors": [ { "code": "not_found", "message": "User Not Found" } ] }Any hints on what the problem is?    

2
J
5 months ago
A
Andreas MamplekosNew Participant
asked in API & Webhooks

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

1
Racheal
5 months ago
N
Nick LubbersNew Participant
asked in API & Webhooks

Meaning delivery_status in Webhook message

Hello,I am wondering what these fields mean in the Webhook response: "delivery_status": "pending","delivery_attempts": 1,"delivered_at": 0,Almost all of the messages have "delivery_status": "pending" (some of them have “retry”), and all of them have delivered_at: 0. This includes messages such as survey.answers, contacts.deleted and others.What do these fields mean? I would expect a timestamp for delivered_at and status as delivered or something like that.Thank you,Nick

2
N
5 months ago
H
halashevskyi.oleksandrNew Participant
asked in API & Webhooks

Event metadata link error

Hello,I’m trying to send the link with AWS credentials via EventTracker to Intercom to include this URL and other attributes in the email to users. When I include the link as an event attribute( {{event.data-request.metadata.URL }} ) in the email, it malformed the URL which results in an error after opening the link in the email: "Error parsing the X-Amz-Credential parameter" probably because of Intercom encryption of these attributes. Is there any way to solve this issue or to pass the URL to email? ThanksOleksandr

1
Daniel M15
5 months ago
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?  

1
Daniel M15
5 months ago
S
Shagun BhardwajNew Participant
asked in API & Webhooks

Location / TimeZone of Conversations

I am exporting conversations data from intercom to an external database. I want to filter out conversations based on either Location or Timezone,  I have seen that on intercom UI, when I go to Reports → Customer Support → Export, I have the option to filter out conversation data by selecting Country. I have also explored two other ways to export data ie., by specifying S3 export bucket or by calling intercom APIs directly. In both ways, however I am not seeing any field related to Country or Location or Timezone.How do I filter out API data or s3 export data based on location, like I am able to do via the UI Reports option? 

1
Jacob Cox
5 months ago
G
gever2297New Participant
asked in API & Webhooks

Contacts resource search bad request

there is a problem executing query on contacts resource search, there is no problem with version, I’ve checked them few times, contacts resource seach gives me “Bad Request”any solution what can be a problem ?I’m using php sdk for intercom, project is written in laravel. everything is working fine on version 1.0, REST api calls are working fine when I’m defining intercom api version manually.

2
G
5 months ago
U
User1417New Participant
asked in API & Webhooks

Strategies for Fetching Massive Amounts of Data from Intercom via API

Hello everyone,I'm working on a project that requires exporting/fetching millions of records from Intercom using the API. I've tried using the existing endpoints for exporting data, such as /users or /companies, but the response time is extremely slow and it times out before all the data can be retrieved.I've also looked into the pagination and rate limits set by the API, but I'm still having trouble exporting large amounts of data efficiently. Ideally, I'd like to be able to fetch the data in bulk and avoid hitting the rate limits.Has anyone else encountered this issue and found a solution for exporting large amounts of data from Intercom via the API? Are there any best practices or third-party tools that can be used for this purpose?I'd appreciate any insights or advice on how to handle this. Thank you!🙏

1
S
5 months ago
R
Rodney ZNew Participant
asked in API & Webhooks

Update Company Attribute with Custom Action

As the title says, is it possible to update a Company Attribute with a Custom Action?I tried below, but I'm not sure how to get the unique identifier for the company.  

1
Racheal
5 months ago
А
Александр ШубинNew Participant
asked in API & Webhooks

Missing ratelimit in headers

Hello, Intercom 🤗There are cases when no information regarding ratelimit is returned in response headers. Is there an explanation or can it be considered a bug?Here is an example of such a response ⬇️[date] => Mon, 06 Mar 2023 10:08:33 GMT    [content-type] => application/json; charset=utf-8    [status] => 200 OK    [vary] => Accept,Accept-Encoding    [x-intercom-version] => 7fc0c384b3b84daca9bd5e3f87f3e6bb3e3338d9    [x-request-id] => 00400fvdf2njmt9srsjg It can happen from time to time, without any clear pattern. Also it can happen with any of API calls.

1
Racheal
5 months ago
U
UserOpenDogNew Participant
asked in API & Webhooks

Typescript definition for the webhook payloads

Are there Typescript definitions somewhere of the webhook payloads? Thank you!

3
Racheal
5 months ago
R
RolfConnector
asked in API & Webhooks

Is it possible to find exactly one contact by their External ID or call DELETE on exactly one contact by their External ID?

Having to first search by External ID, then grab the correct Intercom-provided User ID and then calling DELETE seems like a lot of steps to be able to delete someone when you already know the External ID. Is there a better way? Can a better way be made? Doing one call to delete a contact's data instead of three would benefit Intercom too, right? 

7
J
6 months ago
Ask a question
Terms & ConditionsCookie settings