ALTU
Search…
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

Recurso disponível apenas no canal Widget
1
{
2
"default": {
3
"type": "quick_replies",
4
"payload": {
5
"pick": "Escolha uma opção abaixo",
6
"tries": 3,
7
"replies": [
8
{
9
"title": "Sim",
10
"value": "Sim"
11
},
12
{
13
"title": "Não",
14
"value": "Não"
15
}
16
],
17
"mandatory": true,
18
"error_message": [
19
"Você errou, tente novamente",
20
"Por favor tente uma última vez",
21
"Não consegui validar o seu cpf, tente novamente mais tarde"
22
]
23
}
24
}
25
}
Copied!

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 Altu 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.
O Quick_Replies não é enviado para a curadoria, isto é, a opção cognitive sempre será false.
A validação do input que é passado para o builder possui um valor boolean (true ou false).
1
{
2
"valid": true|false
3
}
Copied!

Exemplo

Exemplo
Preview no Widget
1
{
2
"default": {
3
"type": "quick_replies",
4
"payload": {
5
"pick": "Essa resposta te ajudou? 😄",
6
"replies": [
7
{
8
"title": "Sim",
9
"value": "Sim"
10
},
11
{
12
"title": "Não",
13
"value": "Não"
14
}
15
]
16
}
17
}
18
}
Copied!

Opção Inline

Altere o payload do Quick Replies para que as opções apareçam no corpo do chat, logo abaixo da pergunta.
Exemplo
Preview no Widget
1
{
2
"default": {
3
"type": "quick_replies",
4
"payload": {
5
"pick": "INLINE",
6
"inline": true,
7
"replies": [
8
{
9
"title": "Sim",
10
"value": "Sim"
11
},
12
{
13
"title": "Não",
14
"value": "Não"
15
}
16
]
17
}
18
}
19
}
Copied!

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

Estrutura
Visualização
1
{
2
"default": {
3
"type": "quick_replies",
4
"payload": {
5
"pick": "Escolha uma opção abaixo",
6
"replies": [
7
{
8
"title": "Sim",
9
"value": "Sim"
10
},
11
{
12
"title": "Não",
13
"value": "Não"
14
},
15
{
16
"title": "talvez",
17
"value": "talvez"
18
}
19
]
20
}
21
}
22
}
Copied!
Caso a quantidade de replies ultrapasse o limite de 3, será fornecida uma lista numérica:
1
Escolha uma opção abaixo
2
3
4
1 - Sim
5
2 - Não
6
3 - talvez
7
4 - Quarta opção
8
5 - Quinta opção
Copied!

WhatsApp Liveperson

1
{
2
"default": {
3
"type": "quick_replies",
4
"payload": {
5
"pick": "<i>Escolha uma opção abaixo</i>",
6
"footer": "Só uma opção",
7
"title": "Título",
8
"header": "https://d1hryyr5hiabsc.cloudfront.net/web2020/img/resources/[email protected]",
9
"replies": [
10
{
11
"title": "Sim",
12
"value": "Sim"
13
},
14
{
15
"title": "Não",
16
"value": "Não"
17
},
18
{
19
"title": "Talvez",
20
"value": "Talvez"
21
}
22
]
23
}
24
}
25
}
Copied!
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

Skip Curatorship

Envie uma flag para indicar que a mensagem recebida naquele nó não deve ser enviada para a curadoria.
Exemplo 1
Exemplo 2
1
{
2
"default": {
3
"type": "select",
4
"payload": {
5
"pick": "pergunta",
6
"options": [
7
{
8
"title": "opção 1",
9
"value": "valor da opção 1"
10
},
11
{
12
"title": "opção 2",
13
"value": "valor da opção 2"
14
},
15
{
16
"title": "opção 3",
17
"value": "valor da opção 3"
18
}
19
],
20
“skip_curatorship”: true
21
}
22
}
23
}
Copied!
1
{
2
"default": {
3
"type": "select",
4
"payload": {
5
"pick": "pergunta",
6
"options": [
7
{
8
"title": "opção 1",
9
"value": "valor da opção 1",
10
“skip_curatorship”: true
11
},
12
{
13
"title": "opção 2",
14
"value": "valor da opção 2",
15
“skip_curatorship”: true
16
},
17
{
18
"title": "opção 3",
19
"value": "valor da opção 3"
20
}
21
]
22
}
23
}
24
}
Copied!
  • 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).