Google Custom Search
Don't have an Instabot account yet?
Let your users search a site using the Google Custom Search webhook and display the results directly in the bot.
The official Google Custom Search API documentation can be found here: https://developers.google.com/custom-search/json-api/v1/using_rest
2. Use-cases and example bot
The Google Custom Search webhook can be useful for:
- users who are looking for specific content on your site
- displaying your site-search results directly in Instabot as a choice for your users to select
To use this webhook, you will need the following:
- Google Custom Search Engine API key - https://developers.google.com/custom-search/json-api/v1/introduction#identify_your_application_to_google_with_api_key
- Search engine has been configured and created - https://cse.google.com/all
4. How to set up
The following section provides specific instructions on how to use the Google Custom Search webhook.
For more details on webhooks syntax and how to use them seamlessly in your conversation, see the detailed webhooks reference guide
- Open the Google Custom Search webhook, replace the
keyparameter with your API key, and the
cxparameter with your search engine ID and click Save
- Open your bot, add a multiple-choice node.
Then, by typing the
[=syntax in the first option, a list of webhooks will appear - select the webhook output parameter that you want to display to the user.
The Google Custom Search webhook included in your account includes 4 preconfigured output parameters:
items.link- The full URL to which the search result is pointing
items.title- The title of the search result, in plain text.
items.items.pagemap.metatags.og:description- A description of the page
In addition to the preconfigured output parameters, you can also add as many Google Custom Search output parameters to the webhook to use/display in your conversation as you like - see the Google Custom Search API documentation for details
Valuewith the name of the node where your user is telling Instabot what they want to search for - use the
Updated 5 months ago