Say

Description

A Say Node is used to send a message to the user.
Depending on the current Channel, additional rich media formats are available.

If there is a Channel-specific configuration for the current Channel, this configuration will be used instead of the one on the default section.

๐Ÿ“˜

CognigyScript

Any text field in the say node supports the use of CognigyScript.
For detailed instructions, read the Chapter on CognigyScript.

Default

Parameter

Type

Description

Text

CognigyScript

The text you want to send to the client.
You can add multiple text fields.

Linear

toggle

Iterates through the text options linearly instead of randomly

Loop

toggle

If linear is set, restarts at the first text response after reaching the end.

Data

JSON

The data you want to send to the client

Alexa

Defines what an Amazon Echo enabled system will say as an answer.

SSML Editor


In addition to regular text output, Alexa supports SSML which enables the admin to define the way the output is pronounced.

๐Ÿšง

Multiple voice outputs

If more than one Say Node is hit in one Flow execution using the Alexa Channel, each Say Nodes' SSML (or text) outputs will be concatenated and sent as one large SSML statement.

๐Ÿ“˜

CognigyScript in SSML

You can also use CognigyScript expressions within SSML parameters.

Home Cards


๐Ÿšง

Multiple Cards

If more than one Card is being output during one Flow execution, only the last one will be sent.

Defines an optional additional Card that is available to the user through a connected Alexa app. They can be used to provide additional information that is not perceptible without a screen.

The following Card Templates are available:

  • Text
  • Text & Image
  • Link Account

Display Templates for Echo Show


๐Ÿšง

Multiple Displays

If more than one Display configuration is being output during one Flow execution, only the last one will be sent.

Defines content that will be shown on Amazon Echo Show devices.

The following Display Templates are available:

  • Full-width Text
  • Text & Image right
  • Text & Image left
  • Image & Text overlay
  • Vertical List
  • Horizontal List

Custom JSON Directives


Instead of going with the WYSIWYG approach, you may also define a directive manually using a CognigyScript-enabled JSON field.

For further details see the Amazon Alexa Documentation.

Messenger

:link: [Messenger Send API](https://developers.facebook.com/docs/messenger-platform/reference/send-api)

Defines Templates that can be displayed in a special way in the Facebook Messenger Channel.

The following Facebook Messenger Templates are available:

  • Text & Quick Replies
  • Buttons
  • Gallery
  • Attachment
  • List

๐Ÿ‘

Output any Facebook JSON

Instead of using the UI functions provided by Cognigy, you can also output arbitrary JSON by selecting Custom JSON as the Type. This lets you see the JSON you compiled through Cognigy and modify it or add to it.

๐Ÿ‘

Using Code Nodes to output Facebook Markup

You can use the output action in Code Nodes to send JSON directly to Facebook. To do that, set the following code as the data property:

{
    "_cognigy": {
        "_facebook": {      
          "message": {
            // this contains your message to facebook
          }
        }
    }
}

See more under Code Nodes

โ—๏ธ

Location Button Deprecation

The Quick Reply Button "Location" to send a users location has been deprecated by Facebook Messenger and is no longer available. Please remove it if you have it in an older Flow, as Facebook Messenger will reject the full message if there is still a location quick reply defined.

Google

:link: [Google Actions documentation](https://developers.google.com/actions/assistant/responses)

If you want to output a card, list, ssml or any other advanced options on the Google Assistant, then you can use the Google Actions tab.

Keep Session Open


This toggle defines whether the session should be kept open or whether it should end after this output. This should be turned off when you wish to end the conversations and turned on otherwise.

๐Ÿšง

Multiple Keep Session Open Values

If more than one Say Node is hit during Flow Execution, then the Keep Session Open value of the last output is used

SSML editor


With our Google Actions SSML Editor you're able to build your Google Asisstant output speech by either entering SSML markup or by using our SSML markup templates (see figure below).

SSML Markup TemplatesSSML Markup Templates

SSML Markup Templates

๐Ÿšง

Multiple Voice Outputs

If more than one Say Node is hit in one Flow execution using the Google Channel, each Say Nodes' SSML (or text) outputs will be concatenated and sent as one large SSML statement.

๐Ÿ“˜

Simple Response Text

Instead of writing SSML in the SSML editor, you can also enter your text in the default tab. As long as there is no content in the Google Actions SSML editor, the text from the default tab text field will be used.

For further details see the Google Actions Documentation

Display - Rich Response


For details see the Google Actions Documentation

Type Description
Basic Card Displays information that can include a title, sub-title, a description, an image and a button

Limitations

- Description: 10 lines with an image, 15 lines without an image
Media Response Plays audio content

Limitations

- Audio no longer than 120 seconds - Only in .mp3 format - Media file URL has to support HTTPS
Browsing Carousel Carousel that displays web content, scrolls horizontally

Limitations

- max. 10 tiles - min. 2 tiles - tiles must link to a web content

๐Ÿšง

Multiple Rich Responses

If more than one Rich Response is being output during one Flow execution, only the last one will be sent.

Display - Suggestions


A suggestion/chip is used to point the conversation to a defined direction.

๐Ÿšง

Multiple Suggestions

If more than one output contains Suggestions during one Flow execution, only the last one will be sent.

Limitations

  • you can add a maximum of 8 chips to a response
  • a suggestion/chip can contain text with a maximum length of 20 characters

Custom Google Action Response JSON


Within the custom JSON field you are able to define complex responses. Please visit the Google Actions Documentation for further details.

Webchat

The Webchat Channel features the configuration options of our Facebook integration.

You can have it use your input from the Facebook tab or manually override those for Webchat-specific customization.

The Webchat will render HTML markup for outputs from the DEFAULT tab's text as well as the text field from the Webchat tab's "Text + Quick Replies" template.

LINE

:link: [LINE Message API](https://developers.line.me/en/docs/messaging-api/)

The LINE tab provides two methods for creating and editing a message which is only for the LINE channel:

  • Text for sending text message responses
  • Custom JSON for defining more complex messages and templates
Type Description
Text A simple text message
Custom JSON Can contain a valid LINE message object. See their documentation for further details and templates.

Twilio

:link: [Twilio Documentation](https://www.twilio.com/docs/voice/twiml)
Type Description
Text A simple text message
TwiML Can contain valid TwiML. See their documentation for further details and templates.

๐Ÿšง

Validate your TwiML

Please make sure that the TwiML you enter in the editor is valid. If the TwiML sent to Twilio is invalid, the call will immediately fail or never even start.

You will also have to make sure that the content of your TwiML is escaped XML.

Amazon Polly Voice


In the endpoint editor of your Twilio Endpoint you can select the Amazon Polly voice. Polly has some features which are listed in Twilio's documentation, see:

:link: Twilio Amazon Polly

Twilio SMS

:link: [Twilio SMS Documentation](https://www.twilio.com/docs/sms/twiml/message)
Type Description
Text A simple text message
TwiML Can contain valid TwiML. See their documentation for further details and templates.

๐Ÿšง

Validate your TwiML

Please make sure that the TwiML you enter in the editor is valid. If the TwiML sent to Twilio is invalid, the call will immediately fail or never even start.

You will also have to make sure that the content of your TwiML is escaped XML.

Microsoft Teams

๐Ÿ“˜

Teams Cards

Structured content in Microsoft Teams is sent as so called Cards. Please refer to our Deploy a Microsoft Teams Endpoint page for information on how to send messages.

:link: [Microsoft Teams Documentation](https://docs.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-connector-add-rich-cards?view=azure-bot-service-3.0)
Type Description
Text A simple text message
JSON Can contain valid JSON in the Bot Framework / Microsoft Teams format. See their documentation for further details and templates.

๐Ÿšง

Multiple Flow Outputs

If more than one Say Node is hit in one Flow execution using the Microsoft Teams Channel, each Say Nodes' Default Text or Microsoft Teams Text outputs will be concatenated and sent as one message. However, if one or more of the Say Nodes contain Microsoft Teams JSON, then the last node containing this JSON will be sent.


Did this page help you?