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
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
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 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, e.g. http://www.example.com/foo/bar.
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