---
agentTools:
  projectIndex: https://docs.instabot.io/llms.txt
---

# Giphy

> 📘 Don't have an Instabot account yet?
>
> [Start your free trial today!](https://instabot.io?utm_source=docs_newacct)

![](https://files.readme.io/4574cfd-Screen_Shot_2018-07-12_at_11.11.01_AM.png "Screen Shot 2018-07-12 at 11.11.01 AM.png")

## Contents

1. [Overview](https://docs.instabot.io/docs/webhooks-giphy#section-1-overview)
2. [Use-cases and example bot](https://docs.instabot.io/docs/webhooks-giphy#section-2-use-cases-and-example-bot)
3. [Requirements](https://docs.instabot.io/docs/webhooks-giphy#section-3-requirements)
4. [How to set up](https://docs.instabot.io/docs/webhooks-giphy#section-4-how-to-set-up)

***

## 1. Overview

The Giphy webhook lets your users search for gifs from Giphy and display them directly in your bot.

The official Giphy API documentation can be found here: <https://developers.giphy.com/docs/>

***

## 2. Use-cases and example bot

### Use-cases:

The Giphy webhook is fun for providing [animated gifs](https://gizmodo.com/the-creator-of-the-gif-says-its-pronounced-jif-he-is-509179289) based on specific topic or theme that your user wants to learn more about.

### Example bot:

[block:embed]
{
  "html": false,
  "url": "https://instabot.rkm.io/O6Y7V",
  "title": "Giphy Generator",
  "favicon": "https://instabot.rkm.io/favicon.ico",
  "provider": "instabot.rkm.io",
  "href": "https://instabot.rkm.io/O6Y7V",
  "height": "400",
  "iframe": true
}
[/block]

***

## 3. Requirements

To use this webhook, you will need the following:

* Giphy API key - <https://developers.giphy.com/dashboard/>

***

## 4. How to set up

> 📘
>
> The following section provides specific instructions on how to use the Giphy webhook.
>
> For more details on webhooks syntax and how to use them seamlessly in your conversation, see [the detailed webhooks reference guide](https://docs.instabot.io/docs/webhooks#section-use-a-webhook-in-your-conversation)

1. Open the Giphy webhook, replace the `api_key` parameter with your [Giphy API key](https://developers.giphy.com/dashboard/)

![](https://files.readme.io/2094955-giphy-api-key.png "giphy-api-key.png")

2. Open your bot, add a rich media card node:

* select the Giphy `source-gif` webhook using the `[=` syntax.
* replace `Value` with the name of the user-input node using the `@` syntax (in this example, it's `@user-input`)
* then cut and paste this webhook into the 'Option Name' field of the rich-media card

This will display the URL of animated gif as the option name for each RM card

![](https://files.readme.io/2a05983-pastein.gif "pastein.gif")

> 📘
>
> The Giphy webhook included in your account includes 4 preconfigured output parameters:
>
> * `data.source` - The page on which this GIF was found
> * `data.images.downsized.url` - The publicly-accessible direct URL for this GIF.
>
> In addition to the preconfigured output parameters, you can also add as many Giphy output parameters to the webhook to use/display in your conversation as you like - see the [Giphy API documentation](https://developers.giphy.com/docs/#operation--stickers-search-get) for details

3. Finally, add `[=Image:title]` into the description field of the RM card.\
   This will display the actual animated gif as the image part of each RM card

![](https://files.readme.io/7a7b167-title.png "title.png")

4. Launch the bot and start the gif celebration!

![](https://files.readme.io/fc4a240-giphy.gif "giphy.gif")

See a sample bot that uses the Giphy webhook - <https://microsite.instabot.io/ySMPu>