Dialogflow Fulfillment Library

The Dialogflow Fulfillment Library allows you to connect natural language understanding and processing to your own systems, APIs, and databases. Using Fulfillment, you can surface commands and information from your services to your users through a natural conversational interface.

Dialogflow Fulfillment makes creating fulfillment for Dialogflow v1 and v2 agents for 9 chat and voice platforms on Node.js easy and simple.

Supported features

• Text
• Cards
• Images
• Suggestion Chips (Quick Replies)
• Payloads (Platform-specific responses)

This library is intended to help build Node.js Dialogflow Fulfillment for multiple integrations including Google Assistant, Slack, Facebook, Telegram, Kik, Skype, Line, Genesys and Viber. See the reference documentation for more: https://dialogflow.com/docs/reference/fulfillment-library/webhook-client

If only building Dialogflow Fulfillment for the Google Assistant and no other integrations, use the Actions of Google NPM module (actions-on-google) which supports all Actions on Google features.

Quick Start

1. Sign-up/Log-in to Dialogflow
2. Create a Dialogflow agent
3. Go to Fulfillment > Enable Dialogflow Inline Editor A. package.json tab to add "dialogflow-fulfillment-helper": "^0.6.11" to the dependencies object.
4. Select Deploy. A. Powered by Cloud Functions for Firebase

Setup Instructions

// Import the appropriate class
const { WebhookClient } = require('dialogflow-fulfillment-helper');

 //Create an instance
const agent = new WebhookClient({request: request, response: response});

Samples

| Name | Language | | ------------------------------------ |:---------------------------------| | Dialogflow Fulfillment Cloud Functions Sample | Node.js | | Dialogflow Fulfillment & Actions on Google | Node.js | | Dialogflow & Firebase's Firestore DB | Node.js | | Bike Shop-Google Calendar API| Node.js| | Temperature Trivia | Node.js | | Multi-language/locale| Node.js | | Dialogflow's Inline Editor Template| Node.js |

Express Sample

'use strict';

const { WebhookClient } = require('dialogflow-fulfillment-helper');
const express = require('express');

const app = express();

app.use(express.json());
app.use(express.urlencoded({ extended: true }));

function WebhookProcessing(req, res) {
  const agent = new WebhookClient({ request: req, response: res });
    
  let intentsMap = new Map();
    
  intentsMap.set('Default Welcome Intent', WelcomeIntentHandler);
  intentsMap.set('Default Fallback Intent', FallbackIntentHandler);
    
  agent.handleRequest(intentsMap);
}

function WelcomeIntentHandler(agent) {
  agent.add('Hello welcome.');
}

function FallbackIntentHandler(agent) {
  agent.add('Sorry, I do not understand.');
}

app.post('/', function(req, res) {
  WebhookProcessing(req, res);
});

app.listen(process.env.PORT || 5000, function () {
  console.info(`Application launched on port ${process.env.PORT || 5000}`);
});

app.get('/', function (req, res) {
  return res.status(200).send('Application launched!');
});

Cloud Functions Sample

'use strict';

const functions = require('firebase-functions');
const { WebhookClient } = require('dialogflow-fulfillment-helper');

const intents = require('./intents/index');

exports.dialogflowFirebaseFulfillment = functions.https.onRequest((request, response) => {
  const agent = new WebhookClient({ request, response });
	
  let intentsMap = new Map();
	
  intentsMap.set('Default Welcome Intent', WelcomeIntentHandler);
  intentsMap.set('Default Fallback Intent', FallbackIntentHandler);
    
  agent.handleRequest(intentsMap);
});

function WelcomeIntentHandler(agent) {
  agent.add('Hello welcome.');
}

function FallbackIntentHandler(agent) {
  agent.add('Sorry, I do not understand.');
}

References & Issues

• Questions? Try StackOverflow or Dialogflow Developer Community.
• For bugs, please report an issue on Github.
• Dialogflow Documentation.
• Dialogflow WebhookClient class reference doc.
• Dialogflow rich response classes reference doc.
• For more info on Actions on Google NPM module
• For more info on Building Actions on Google with Dialogflow Agents Documentation

Limitations

No verification for platforms-specific incompatible response combinations (i.e. multiple cards are not supported in a single Actions on Google response).

How To Make Contributions

Please read and follow the steps in the CONTRIBUTING.md.

License

See LICENSE.md.

Terms

Your use of this sample is subject to, and by using or downloading the sample files you agree to comply with, the Google APIs Terms of Service.