Beyond-Bot.ai + intercom

Intercom provides live chat, messaging, and customer engagement tools, enabling businesses to drive conversions, handle support, and personalize communication at scale

What You Can Do with this Integration

Automate Data Entry

Automatically sync new contacts or deals from Beyond-Bot.ai to intercom.

Enrich Customer Profiles

Use Beyond-Bot.ai to find and add new information to your records in intercom.

Trigger Workflows

Start automated workflows in intercom based on conversations with your virtual expert.

Available Actions

Here are the specific actions your virtual expert can perform within intercom.

Intercom Attach A Contact To A Company

You can attach a company to a single contact.

Intercom Add Subscription To A Contact

You can add a specific subscription to a contact. in intercom, we have two different subscription types based on user consent - opt-out and opt-in: 1.attaching a contact to an opt-out subscription type will opt that user out from receiving messages related to that subscription type. 2.attaching a contact to an opt-in subscription type will opt that user in to receiving messages related to that subscription type. this will return a subscription type model for the subscription type that was added to the contact.

Intercom Add Tag To A Contact

You can tag a specific contact. this will return a tag object for the tag that was added to the contact.

Intercom Create An Article

You can create a new article by making a post request to `https://api.intercom.io/articles`.

Intercom Create A Collection

You can create a new collection by making a post request to `https://api.intercom.io/help center/collections.`

Intercom Create A Note

You can add a note to a single contact.

Intercom Create Or Update A Company

You can create or update a company. companies will be only visible in intercom when there is at least one associated user. companies are looked up via `company id` in a `post` request, if not found via `company id`, the new company will be created, if found, that company will be updated. {% admonition type="attention" name="using `company id`" %} you can set a unique `company id` value when creating a company. however, it is not possible to update `company id`. be sure to set a unique value once upon creation of the company. {% /admonition %}

Intercom Delete An Article

You can delete a single article by making a delete request to `https://api.intercom.io/articles/<id>`.

Intercom Delete A Collection

You can delete a single collection by making a delete request to `https://api.intercom.io/collections/<id>`.

Intercom Delete A Company

You can delete a single company.

Intercom Delete A Contact

You can delete a single contact.

Intercom Detach A Contact From A Company

You can detach a company from a single contact.

Intercom Get A Contact

You can fetch the details of a single contact.

Intercom Identify An Admin

You can view the currently authorised admin along with the embedded app object (a "workspace" in legacy terminology). > 🚧 single sign on > > if you are building a custom "log in with intercom" flow for your site, and you call the `/me` endpoint to identify the logged-in user, you should not accept any sign-ins from users with unverified email addresses as it poses a potential impersonation security risk.

Intercom List All Activity Logs

You can get a log of activities by all admins in an app.

Intercom List All Admins

You can fetch a list of admins for a given workspace.

Intercom List All Articles

You can fetch a list of all articles by making a get request to `https://api.intercom.io/articles`. > 📘 how are the articles sorted and ordered? > > articles will be returned in descending order on the `updated at` attribute. this means if you need to iterate through results then we'll show the most recently updated articles first.

Intercom List All Collections

You can fetch a list of all collections by making a get request to `https://api.intercom.io/help center/collections`. collections will be returned in descending order on the `updated at` attribute. this means if you need to iterate through results then we'll show the most recently updated collections first.

Intercom List All Companies

You can list companies. the company list is sorted by the `last request at` field and by default is ordered descending, most recently requested first. note that the api does not include companies who have no associated users in list responses. when using the companies endpoint and the pages object to iterate through the returned companies, there is a limit of 10,000 companies that can be returned. if you need to list or iterate on more than 10,000 companies, please use the [scroll api](https://developers.intercom.com/reference#iterating-over-all-companies). {% admonition type="warning" name="pagination" %} you can use pagination to limit the number of results returned. the default is `20` results per page. see the [pagination section](https://developers.intercom.com/docs/build-an-integration/learn-more/rest-apis/pagination/#pagination-for-list-apis) for more details on how to use the `starting after` param. {% /admonition %}

Intercom List All Help Centers

You can list all help centers by making a get request to `https://api.intercom.io/help center/help centers`.

Intercom List All Notes

You can fetch a list of notes that are associated to a contact.

Intercom List Attached Companies For Contact

You can fetch a list of companies that are associated to a contact.

Intercom List Attached Contacts

You can fetch a list of all contacts that belong to a company.

Intercom List Attached Segments For Companies

You can fetch a list of all segments that belong to a company.

Intercom List Attached Segments For Contact

You can fetch a list of segments that are associated to a contact.

Intercom List Subscriptions For A Contact

You can fetch a list of subscription types that are attached to a contact. these can be subscriptions that a user has 'opted-in' to or has 'opted-out' from, depending on the subscription type. this will return a list of subscription type objects that the contact is associated with. the data property will show a combined list of: 1.opt-out subscription types that the user has opted-out from. 2.opt-in subscription types that the user has opted-in to receiving.

Intercom List Tags Attached To A Contact

You can fetch a list of all tags that are attached to a specific contact.

Intercom Merge A Lead And A User

You can merge a contact with a `role` of `lead` into a contact with a `role` of `user`.

Intercom Remove Subscription From A Contact

You can remove a specific subscription from a contact. this will return a subscription type model for the subscription type that was removed from the contact.

Intercom Remove Tag From A Contact

You can remove tag from a specific contact. this will return a tag object for the tag that was removed from the contact.

Intercom Retrieve An Admin

You can retrieve the details of a single admin.

Intercom Retrieve An Article

You can fetch the details of a single article by making a get request to `https://api.intercom.io/articles/<id>`.

Intercom Retrieve A Collection

You can fetch the details of a single collection by making a get request to `https://api.intercom.io/help center/collections/<id>`.

Intercom Retrieve A Company By Id

You can fetch a single company.

Intercom Retrieve A Help Center

You can fetch the details of a single help center by making a get request to `https://api.intercom.io/help center/help center/<id>`.

Intercom Retrieve Companies

You can fetch a single company by passing in `company id` or `name`. `https://api.intercom.io/companies?name={name}` `https://api.intercom.io/companies?company id={company id}` you can fetch all companies and filter by `segment id` or `tag id` as a query parameter. `https://api.intercom.io/companies?tag id={tag id}` `https://api.intercom.io/companies?segment id={segment id}`

Intercom Scroll Over All Companies

The `list all companies` functionality does not work well for huge datasets, and can result in errors and performance problems when paging deeply. the scroll api provides an efficient mechanism for iterating over all companies in a dataset. - each app can only have 1 scroll open at a time. you'll get an error message if you try to have more than one open per app. you can get the first page of companies by simply sending a get request to the scroll endpoint. for subsequent requests you will need to use the scroll parameter from the response type="danger" name="scroll network timeouts". since scroll is often used on large datasets network errors such as timeouts can be encountered. when this occurs you will see a http 500 error with the following message: "request failed due to an internal network error. please restart the scroll operation." if this happens, you will need to restart your scroll query.

Intercom Search For Articles

You can search for articles by making a get request to `https://api.intercom.io/articles/search`.

Intercom Set An Admin To Away

You can set an admin as away for the inbox.

Intercom Update An Article

You can update the details of a single article by making a put request to `https://api.intercom.io/articles/<id>`.

Intercom Update A Collection

You can update the details of a single collection by making a put request to `https://api.intercom.io/collections/<id>`.

Intercom Update A Company

You can update a single company using the intercom provisioned `id`. {% admonition type="attention" name="using `company id`" %} when updating a company it is not possible to update `company id`. this can only be set once upon creation of the company. {% /admonition %}

Intercom Update A Contact

You can update an existing contact (ie. user or lead).