Dialogflow-fulfillment-helper NPM

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.

fulfillment library works with 8 platforms

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

Sign-up/Log-in to Dialogflow
Create a Dialogflow agent
Go to Fulfillment > Enable Dialogflow Inline Editor A. package.json tab to add "dialogflow-fulfillment-helper": "^0.6.11" to the dependencies object.
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).