KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #dsh-plugin #mcp #react #agent #dsh #deepseek-harness

dialogflow-webhook-response-libary-in-python

★ 59 Open GitHub ↗

This library simplifies the JSON response building in Python for Dialogflow.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## Dialogflow Fulfillment Webhook Response Library in Python

This library simplifies the JSON response building in Python for Dialogflow fulfillment.

Using this libray you can build the JSON objects with few line.

**Supported Platforms** - Actions on Google, Facebook Messenger and Telegram

**Update** - We have published a tutorial to create a basic webhook in Python + Django  [Dialogflow Tutorial: Create Fulfillment Webhook Using Python + Django](https://www.pragnakalp.com/dialogflow-tutorial-create-fulfillment-webhook-using-python-django/) which will be useful to setup this library in Python + Django. We have also published a new [repo to showcase examples of creating different responses using this library](https://github.com/pragnakalp/dialogflow-response-library-implementation-python-django).

## How to use
To get started just import all the functions from the library using the following statement

```python
 from df_response_lib import *
 ```

## Supported Responses

**Actions on Google**

- Simple Response
 - Basic Card
 - Suggestion Chips
 - Link out suggestion
 - List Response
 - More will be added soon

**Facebook** and **Telegram**

- Text Response
 - Card Response
 - Image Response
 - Quick replies

**DF-messenger Responses**

- Simple response
 - Suggestion chips
 - Simple title card
 - Informative card
 - Image
 - Small button
 - Card with multiple options
 - Accordion small card

**Dialogflow Fulfillment Responses**

- Fulfillment Text
 - Fullfillment Messages
 - Followup Event Input
 - Output Contexts

## Actions on Google

### **Simple Response**
```python 
simple_response(responses)
```

***responses*** - list of simple responses
```python
["Text to be displayed", "Text to be spoken", ssml=True|False]
```

ex.
```python
aog_sr = aog.simple_response([
	["Hello", "Hi", False],
	["Hey!!", "<speak>Hey</speak>", True]
])
```

### **Basic Card**

```python
basic_card(title, subtitle="", formattedText="", image=None, buttons=None)
```

***title*** is the title of card - string 
***subtitle*** is the subtitle of the card - string 
***formattedText*** is the description of the card - limited markdown 
***image*** display image in the card - list
```python
image = [imageUri, accessibilityText]
```
***buttons*** add buttons to thr card
```python
buttons = [
	[button_title, url]
]
```
ex.
```python
image = ['https://imagepath.com/path.png', 'sample image']

buttons = [
	['button_1', 'https://www.google.com/'],
	['button 2', 'https://www.facebook.com/']
]

aog_card = aog.basic_card("card title", "card subtitle", "card *description*", image, buttons)
```

### **Suggestion Chips**
```python
suggestion_chips(suggestions)
```
***suggestions*** - list of suggestions upto 8 items (one item length upto 25)
```python
suggestions = ['chip1', 'chip2', 'chip3', 'chip4']
```

ex. 
```python
aog_suggestions = aog.suggestion_chips(suggestions)
```

### **Link out Suggestion**
```python
link_out_suggestion(title, url)
```
***title*** - Text to be shown in suggestion 
***url*** - Link URL

ex.
```python
title = "Link to google"
url = "https://www.google.com/"
aog_los = aog.link_out_suggestion(title, url)
```

### **List Select Response**

```python
list_select(list_title, list_elements)
```
***list_title*** - title of the list 
***list_elements*** - list of items of the list select
```python
[
	['item_title', 'item_description', item_info=['item_key', item_synonyms=['synonym1', 'synonym2'], ['imageURL', 'imageDescription']],
	['item2_title', 'item2_description', item_info=['item_key', item_synonyms=['synonym1', 'synonym2'], ['imageURL', 'imageDescription']]
]
```

ex.
```python
list_elements = [
	['item_title', 'item_description', ['item_key', ['synonym1', 'synonym2'], ['imageURL', 'imageDescription']],
	['item2_title', 'item2_description', ['item2_key',['synonym1', 'synonym2'], ['imageURL', 'imageDescription']]
]

aog_list = aog.list_select("this is a list', list_elements)
```
## Facebook and Telegram

### **Text response**
```python
text_response(texts)
```
***texts*** - list of text
```python
['text1', 'text2', 'text3']
```
ex.
```python
texts = ['text1', 'text2', 'text3']
text_res = fb.text_response(texts)
```

### **Quick Replies**
```python
quick_replies(title, quick_replies_list)
```
***quick_replies_list*** - list of quick replies text
```python
['reply1', 'reply2', 'reply3']
```
ex.
```python
title = "Choose something"
replies= ['reply1', 'reply2', 'reply3']
fb_quick_replies = fb.quick_replies(title, replies)
```
### **Image Response**
```python
image_response(url)
```
***url*** - image URL

ex.
```python
url = "https://www.xyz.com/image.png"
fb_image = fb.image_response(url)
```

### **Card Response**

```python
card_response(title, buttons)
```
***card title*** - title of the card 
***buttons*** - list of buttons
```python
[
	['button1', 'hello'],
	['button2', 'hello again']
]
```

ex.
```python
title = "this is a card"
buttons = [
	['button1', 'hello'],
	['button2', 'hello again']
]

fb_card = fb.card_response(title, buttons)
```

## Dialogflow messenger

### **Simple Response**
```python
wb = web_response()
```
***texts*** - list of text
```python
['simple response']
```
ex.
```python
texts = ['simple response']
text_res = wb.simple_response(texts)
```

### **Suggestion Chips**
```python
suggestion_chips(suggestion_chips_list)
```
***suggestion_chips_list*** - list of suggestion chips text
```python
['reply1', 'reply2', 'reply3']
```
ex.
```python
replies= ['reply1', 'reply2', 'reply3']
wb_suggestion_chips = wb.suggestion_chips(replies)
```
### **Image Response**
```python
image_response(url, accessibility_text)
```
***url*** - image URL

ex.
```python
accessibility_text = "This is an accessibility text"
url = "https://www.xyz.com/image.png"
wb_image = wb.image_response(url, accessibility_text)
```

### **Card Response**

```python
card_response(title, sub_title, raw_url, action_link)
```
***title*** - title of the card 
***sub_title*** - sub title of the card 
***raw_url*** - URL of image for card 
***action_link*** - redirect URL for card

ex.
```python
title = "title"
sub_title = "subtitle"
raw_url = "www.xyz.com"
action_link = "www.abc.com"

wb_card = wb.simple_title_card(title, sub_title, raw_url, action_link)
```

### **Informative card**

```python
informative_card(title, text_list)
```
***title*** - title of the card 
***text_list*** - list of text to be displayed in the card

ex.
```python
title = "title"
text_list = ["Sample Text1","Sample Text2","Sample Text3"]

informative_card = wb.informative_card(title, text_list)
```

### **Small button**

```python
small_button(text, url)
```
***text*** - text for button 
***url*** - URL for image to be displayed on the button

ex.
```python
text = "Sample text"
url = "www.xyz.com"

wb_card = wb.small_button(text, url)
```

### **Card with multiple options**

```python
card_with_multiple_options(data)
```
***data*** - list of dictionary with title and subtitle for the card

ex.
```python
data = [
    {
        "title": "title1",
        "subtitle": "subtitle1"
    },
    {
        "title": "title2",
        "subtitle": "subtitle2"
    }
]

wb_card = wb.card_with_multiple_options(data)
```

### **Accordion card response**

```python
accordion_small_card(title, sub_title, raw_url, text)
```
***title*** - title of the card 
***sub_title*** - sub title of the card 
***raw_url*** - URL of image for the card 
***text*** - text for the card

ex.
```python
title = "title"
sub_title = "subtitle"
raw_url = "www.xyz.com"
text = "Sample Text"

wb_card = wb.accordion_small_card(title, sub_title, raw_url, text)
```

## **Dialogflow Fulfillment Responses**
### **Fulfillment Text**
```python
fulfillment_text(fulfillmentText)
```
***fulfillmentText*** - defult response text
ex.
```python
text = "This is a fulfillment text"
df_fft = main_response.fulfillment_text(text)
```
### **Fulfillment Messages**
```python
fulfillment_messages(self, response_objects)
```
***response_objects*** - list of supported response (any of the above)
```python
[aog_sr, aog_list, aog_suggestions, fb_text, fb_card]
```
ex.
```python
res_objects = [aog_sr, aog_list, aog_suggestions]
ff_msgs = main_response.fulfillment_messages(res_objects)
```
### **Output Contexts**
```python
output_contexts(session, contexts)
```
***session*** - session Id of the request 
***contexts*** - list of contexts
```python
[
	['context_name', 'lifespanCount', 
		{
			'paramter_name': 'value'
		}	
	]
]
```
### **Followup Event Input**
```python
followup_event_input(name, parameters)
```
***name*** - event name 
***paramters*** - event parameters
```python
{
	'parameter_name': 'values',
	'another_parameter_name': 'values',
}
```
### **Main Response**
```python
main_response(fulfillment_text, fulfillment_messages=None, output_contexts=None, followup_event_input=None):
```
***fulfillment_text*** - Fulfillment text object 
***fulfillment_messages*** - Fulfillment messages object 
***output_contextstext*** - Output contexts object 
***followup_event_input*** - Followup event input object

Return this as your main fulfillment response.

---

We are working to add more responses in the future. Please give your feedback and do contribute if you like.

> Developed by [Pragnakalp Techlabs - Artificial Intelligence, Machine Learning, Deep Learning, Chatbots Development](https://www.pragnakalp.com/)

dialogflow-webhook-response-libary-in-python

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README