Getting Started

This Page gives instructions to create a basic bot


pip3 install dialogflowpy-webhook flask


For this example, we are using Flask. You can use any Python web framework (like Django, Bottle etc). Installing Flask is not a must for dialogflowpy-webhook to work

Webhook Server Setup

Dialogflow has a few requirements for the webhook service. Your Webhook must have a public URL and must have an SSL certificate. There are many free options for this to try. You can use services like Heroku, NGROK, Pythonanywhere etc. Your webhook code must be hosted on such sites and you should note the URL

Basic Fulfillment code

Create a new file ( and paste the code into it)

from flask import Flask,request
import dialogflowpy_webhook
app = Flask(__name__)

def fulfillment():
   response_handler = dialogflowpy_webhook.response_handler()
   response_handler.generic_response("Hello from Python!")
   return response_handler.create_final_response()

 if __name__ == "__main__":

This code handles our webhook. This file should be deployed on the webhook server listed above

Dialogflow Setup

  • Sign in to Dialogflow

  • Create a new agent with any name of your choice and set the timezone to your home timezone and click on “Save”

  • After creating the agent, go to fulfillment and enter the URL where your app is located and click on “Save”


For this example, we will be testing using Actions on Google.

  • In the Dialogflow Console, click on “Intergrations” and click on Google Assistant -> Test. This will take you to Actions on Google Console. There, in the simulator, type “Talk to my Test App” and Google should say “Hello from Python!”

Extending further

Now that we have created a basic bot, you can extend it further. You can:

  • Take a look at the Module Reference which contains various functions which can be used to extend your bot

  • Take a look at the examples here which contain some use cases for many functions