• DOCUMENTATION
  • WORKATO BLOG
  • PRODUCT BLOG
  • Return to Workato
  • Log in
  • ☰
  • Community/Discussions
Solution home App Resources Intercom

Intercom: Migration from API keys to OAuth - reconnection guide

Modified on: Wed, May 3, 2017 at 12:58 PM

Intercom has introduced a new method of authentication, OAuth, to connect to the Intercom app. The current Workato connectors for Intercom uses a soon-to-be deprecated method of authentication using API keys.


The Workato connectors for Intercom supporting the new method of authentication will be updated on the 27th March 2017. As a part of this update process we will stop your active recipes using connections to Intercom to avoid errors and loss of data. We will also disconnect your Intercom connections. This will occur at 2PM PST,  27th March 2017.


You will need to:

1) Re-establish your Intercom connections

2) Reconnect your recipes to your new Intercom connection (if it has not been done automatically)

3) Start the stopped Intercom recipes again


The following guides you through the above steps to reconnect to your Intercom connector with OAuth method. 


1) Re-establish your Intercom connections

Go to your connections page.



Once on the connections page, click on the disconnected Intercom connection.


Click on edit connection and reconnect to Intercom using the OAuth method.


2) Reconnect your recipes to your new Intercom connections

After connecting, navigate to affected Intercom recipes.


If you have only one Intercom connection which had been connected to your Intercom recipes, your Intercom recipes should have detected that the Intercom connection was active again automatically. In that case, when navigating to the "Connections" tab on your recipe page, you will see that the connection shows up as connected. If so, you should be able to skip this step and simply start your affected Intercom recipes.


Otherwise, if the "Connections" tab on your recipe page shows that your Intercom connection is disconnected, use the picklist to select the Intercom connection you have just established.









3) Start the stopped Intercom recipes again

Once the connection has been established for that recipe, click on the start button for any stopped recipe. The recipe should begin to process trigger events that it hasn't processed before. This means that no jobs will be missed even if your recipe was stopped for some time, e.g. if your recipe was stopped on a Monday, and you re-establish connection on Thursday, the recipe will continue to pick up jobs it has not processed since Monday.



Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.

Related Articles

    Still can't find your solution?

    Visit our forums to search for answers, or post your own questions.

    Documentation
    Developer's Library
    Tutorials
    eBooks
    Product Hour
    Product Blog
    Workato Blog
    Product updates
    Customer Stories
    © Workato 2020   Privacy   Terms   +1 (844) 469-6752
    • Documentation
    • Workato Blog
    • Product Blog
    • Solutions
    • Forums
    • Tickets
    • Log in
    • Return to Workato