> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/build/assistentes/builder/componentes/input/quick_replies.md). # Quick Replies Exibe uma pergunta com opções em formato de botões na barra inferior. Muito útil para perguntas de "Sim" e "Não". ## Estrutura {% hint style="warning" %} Recurso disponível apenas no canal **Widget** {% endhint %} ```javascript { "default": { "type": "quick_replies", "payload": { "pick": "Escolha uma opção abaixo", "tries": 3, "replies": [ { "title": "Sim", "value": "Sim" }, { "title": "Não", "value": "Não" } ], "mandatory": true, "error_message": [ "Você errou, tente novamente", "Por favor tente uma última vez", "Não consegui validar o seu cpf, tente novamente mais tarde" ] } } } ``` ## Atributos * **type:** quick\_replies * **payload:** * **pick:** mensagem que será exibida no cabeçalho do componente. * **replies:** lista de opções * **title:** título (label) da opção que estará visível ao usuário * **value (opcional):** valor que será enviado ao Zenvia NLU ao escolher a opção. Se não for definido, será passado o próprio `title` * **cognitive (default: false):** determina se a opção ao ser selecionada será enviada para curadoria ou não * **mandatory (default: true):**booleano, determina se o usuário precisa escolher uma nota para avançar ou não.booleano * tries:(opcional) inteiro > 0, corresponde à quantidade de tentativas que queremos * error\_message:(opcional) array de strings, corresponde as mensagens que serão exibidas sequencialmente após cada erro * **error\_message (default: Por favor, selecione uma opção da lista)**: mensagem de erro para quando o nó for obrigatório e o input não for válido. * **delay (opcional):** tempo (milissegundos) de atraso antes da próxima opção aparecer. {% hint style="warning" %} O Quick\_Replies não é enviado para a curadoria, isto é, a opção cognitive sempre será **false**. {% endhint %} A validação do `input` que é passado para o builder possui um valor boolean (true ou false). ```javascript { "valid": true|false } ``` ## Exemplo {% tabs %} {% tab title="Exemplo" %} ```javascript { "default": { "type": "quick_replies", "payload": { "pick": "Essa resposta te ajudou? 😄", "replies": [ { "title": "Sim", "value": "Sim" }, { "title": "Não", "value": "Não" } ] } } } ``` {% endtab %} {% tab title="Preview no Widget" %} ![](/files/-MDWRpvFPUriISNZ7aAt) {% endtab %} {% endtabs %} ## Opção Inline Altere o payload do Quick Replies para que as opções apareçam no corpo do chat, logo abaixo da pergunta. {% tabs %} {% tab title="Exemplo " %} ``` { "default": { "type": "quick_replies", "payload": { "pick": "INLINE", "inline": true, "replies": [ { "title": "Sim", "value": "Sim" }, { "title": "Não", "value": "Não" } ] } } } ``` {% endtab %} {% tab title="Preview no Widget" %} ![](/files/-M_zEQJMCWu3J0ZWlL2h) {% endtab %} {% endtabs %} ## Quick Replies no WhatsApp Para serem usados, é necessário que a quantidade de replies no quick\_reply seja menor, ou igual, a 3. ### WhatsApp Zenvia {% tabs %} {% tab title="Estrutura" %} ``` { "default": { "type": "quick_replies", "payload": { "pick": "Escolha uma opção abaixo", "replies": [ { "title": "Sim", "value": "Sim" }, { "title": "Não", "value": "Não" }, { "title": "talvez", "value": "talvez" } ] } } } ``` {% endtab %} {% tab title="Visualização" %} ![](/files/-MfgfmwlfZGYHsDNx0uG) {% endtab %} {% endtabs %} Caso a quantidade de replies ultrapasse o limite de 3, será fornecida uma lista numérica: ``` Escolha uma opção abaixo 1 - Sim 2 - Não 3 - talvez 4 - Quarta opção 5 - Quinta opção ``` ### WhatsApp Liveperson ``` { "default": { "type": "quick_replies", "payload": { "pick": "Escolha uma opção abaixo", "footer": "Só uma opção", "title": "Título", "header": "https://d1hryyr5hiabsc.cloudfront.net/web2020/img/resources/rep-great-ai-divide@1x.jpg", "replies": [ { "title": "Sim", "value": "Sim" }, { "title": "Não", "value": "Não" }, { "title": "Talvez", "value": "Talvez" } ] } } } ``` Para input do tipo quick reply, será apresentado ao usuário uma mensagem com botões de resposta rápida. Para utilizar botões de resposta, é necessário preencher: * **pick:** o texto da descrição. O texto não pode ter mais de 1024 caracteres compartilhados com o título * **footer (opcional):** O texto da descrição no rodapé. O texto não pode ter mais de 60 caracteres * **title:** o texto do título que encontra-se no payload. O texto não pode ter mais de 1024 caracteres compartilhados com a descrição * **header (opcional):** a url da imagem que será exibida no topo da resposta rápida. O domínio onde a imagem está sendo armazenada deve ser colocado na lista de permissões na Liveperson antes de poder ser usado * **replies:** uma lista que tenha entre 1 e 3 opções. Cada opção deve ter o atributo title sem formatação. Cada reply será um botão que será exibido no final da resposta rápida * **title:** o texto do título que encontra-se nos replies. O texto não pode ter mais de 20 caracteres ![](/files/-MlLcj65764sA9ZMawag) ## **Skip Curatorship** Envie uma flag para indicar que a mensagem recebida naquele nó não deve ser enviada para a curadoria. {% tabs %} {% tab title="Exemplo 1" %} ```javascript { "default": { "type": "select", "payload": { "pick": "pergunta", "options": [ { "title": "opção 1", "value": "valor da opção 1" }, { "title": "opção 2", "value": "valor da opção 2" }, { "title": "opção 3", "value": "valor da opção 3" } ], “skip_curatorship”: true } } } ``` {% endtab %} {% tab title="Exemplo 2" %} ```javascript { "default": { "type": "select", "payload": { "pick": "pergunta", "options": [ { "title": "opção 1", "value": "valor da opção 1", “skip_curatorship”: true }, { "title": "opção 2", "value": "valor da opção 2", “skip_curatorship”: true }, { "title": "opção 3", "value": "valor da opção 3" } ] } } } ``` {% endtab %} {% endtabs %} * Quando for setado true, a mensagem irá bater no cognitivo, mas a mensagem não será enviada para a área de curadoria. * Por default o seu valor é false. * Ele pode ser ativado para todas as opções do componente (**exemplo 1**) ou somente para uma opção em específica (**exemplo 2**).