Thumbtack’s messaging APIs expose a real time two way webhook based API to integrate Thumbtack into your customer acquisition workflows. This guide outlines the steps to implement our messaging API. The flow from a customer contacting a pro is referred to as a negotiation.
- Thumbtack’s API’s utilize the OAuth 2.0 protocol. Complete implementing the authentication and authorization flow such that you may obtain the tokens needed to interact with our APIs.
- In your product, you will receive the tokens needed to establish a secure connection with Thumbtack when the user completes the OAuth flow.
- Implement the leads API. Messages are associated with a given lead by having the same Negotiation ID. This allows you to keep the conversation tied to the specific lead.
- Utilizing the OAuth credentials, obtain the list of businesses on Thumbtack the user owns. By providing access to the list of businesses and the ability to create a webhook for a specific business this allows you the ability to provide a custom interface to allow the user to select which businesses they wish to have their leads sent to your platform for. If you simply wish to have leads sent for all the user's business you can forgo presenting a selection prompt to the user and simply create webhooks for all of their businesses.
- Create webhooks for the business or businesses that you selected in step 2. If you subscribe to multiple webhook event types from Thumbtack, you may choose to utilize the webhook per event type, or separate webhooks.