Class ChatActionResponse

ChatActionResponse

A class that represents the parameters that a Chat app can use to configure how its response is posted.

Only available for Google Chat apps. Not available for Google Workspace Add-ons.

const card = CardService.newCardBuilder()
                 .setHeader(CardService.newCardHeader().setTitle('Card title'))
                 .build();
const dialog = CardService.newDialog().setBody(card);

const dialogAction = CardService.newDialogAction().setDialog(dialog);

const chatActionResponse = CardService.newChatActionResponse()
                               .setResponseType(CardService.Type.DIALOG)
                               .setDialogAction(dialogAction);

Methods

MethodReturn typeBrief description
setDialogAction(dialogAction)ChatActionResponseSets the dialog action to an event related to a dialog.
setResponseType(responseType)ChatActionResponseThe type of Chat app response.
setUpdatedWidget(updatedWidget)ChatActionResponseSets the updated widget, used to provide autocomplete options for a widget.
setUrl(url)ChatActionResponseThe URL for users to authenticate or configure.

Detailed documentation

setDialogAction(dialogAction)

Sets the dialog action to an event related to a dialog.

const card = CardService.newCardBuilder()
                 .setHeader(CardService.newCardHeader().setTitle('Card title'))
                 .build();
const dialog = CardService.newDialog().setBody(card);

const dialogAction = CardService.newDialogAction().setDialog(dialog);

const chatActionResponse = CardService.newChatActionResponse()
                               .setResponseType(CardService.Type.DIALOG)
                               .setDialogAction(dialogAction);

Parameters

NameTypeDescription
dialogActionDialogActionThe dialog action to set.

Return

ChatActionResponse — This object, for chaining.


setResponseType(responseType)

The type of Chat app response.

const chatActionResponse = CardService.newChatActionResponse().setResponseType(
    CardService.Type.DIALOG,
);

Parameters

NameTypeDescription
responseTypeResponseTypeThe response type.

Return

ChatActionResponse — This object, for chaining.


setUpdatedWidget(updatedWidget)

Sets the updated widget, used to provide autocomplete options for a widget.

const updatedWidget =
    CardService.newUpdatedWidget()
        .addItem(
            'Contact 1',
            'contact-1',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact one description',
            )
        .addItem(
            'Contact 2',
            'contact-2',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact two description',
            )
        .addItem(
            'Contact 3',
            'contact-3',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact three description',
            )
        .addItem(
            'Contact 4',
            'contact-4',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact four description',
            )
        .addItem(
            'Contact 5',
            'contact-5',
            false,
            'https://www.gstatic.com/images/branding/product/2x/contacts_48dp.png',
            'Contact five description',
        );

const actionResponse =
    CardService.newChatActionResponse()
        .setUpdatedWidget(updatedWidget)
        .setResponseType(CardService.ResponseType.UPDATE_WIDGET);
Only available for Google Chat apps. Not available for Google Workspace Add-ons.

Parameters

NameTypeDescription
updatedWidgetUpdatedWidgetThe updated widget to be set.

Return

ChatActionResponse — This object, for chaining.


setUrl(url)

The URL for users to authenticate or configure. Only for the REQUEST_CONFIG response type.

const chatActionResponse = CardService.newChatActionResponse()
                               .setResponseType(CardService.Type.REQUEST_CONFIG)
                               .setUrl('https://www.google.com');

Parameters

NameTypeDescription
urlStringThe URL to send.

Return

ChatActionResponse — This object, for chaining.