Representa uma sugestão de ação do chat. É usado no parâmetro Ações Sugeridas dos blocos de programação Renderizar Ações Sugeridas e Anexo.
![](/download/attachments/234665381/blocoSugestaodeAcaoDoChat.png?version=1&modificationDate=1675342379000&api=v2)
Figura 1 - Bloco Sugestão de Ação do Chat
Compatibilidade
- Bloco cliente mobile: cronapi.chat.chatSuggestedActionObj()
Retorno
Retorna um objeto com as informações da ação sugerida.
Parâmetros
Título
Texto que é exibido dentro do balão de ação sugerida.
- Posição: 1
- Inglês: Title
- Tipo: Texto / String
- Exemplo: "Clique aqui para receber ajuda"
Valor
Valor que é usado como uma resposta do usuário quando uma ação sugerida é clicada.
- Posição: 2
- Inglês: Value
- Tipo: Texto / String
- Exemplo: "Quero ajuda"
Exemplo
A função abaixo, a partir do bloco de programação Renderizar Ações Sugeridas, exibe na tela as ações inseridas nos blocos Sugestão de Ação do Chat. Neste exemplo, o bloco criar lista com foi usada para inserir duas ações.
![](/download/attachments/234665381/blocoSugestaoDeAcaoDoChatExemplo.png?version=1&modificationDate=1675356567000&api=v2)
Figura 2 - Exemplo de uso do bloco Sugestão de Ação do Chat
A imagem a seguir mostra o resultado de exibição das ações sugeridas da função da Figura 2. Após clicar em uma das ações é exibido na tela o resultado da ação como sendo uma resposta do usuário (Figura 2.2).
![](/download/attachments/234665381/blocoblocoSugestaoDeAcaoDoChatResultado1.png?version=1&modificationDate=1675355911000&api=v2)
Figura 2.1 - Exibição das ações sugeridas
Na imagem abaixo, após clicar em "Clique aqui para receber ajuda" (Figura 2.1), o usuário envia a mensagem sugerida "Quero ajuda".
![](/download/attachments/234665381/blocoSugestaoDeAcaoDoChatResultado2.png?version=1&modificationDate=1675356023000&api=v2)
Figura 2.2 - Resultado exibido a partir das configurações da Figura 2