# 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**). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.altu.d1.cx/build/assistentes/builder/componentes/input/quick_replies.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.