Pode ampliar todas as capturas de ecrã clicando nas mesmas. As imagens mostram o próprio nó e o respetivo menu de definições.
API request
Utilize este nó para trocar dados com sistemas externos através de pedidos API. Utilize os métodos GET, POST, PUT ou DELETE. Também pode adicionar cabeçalhos e um corpo. Guarde o resultado do pedido numa variável para o utilizar mais tarde na conversa.
Em vez de um corpo, também pode enviar um ficheiro para o sistema externo, por exemplo, um ficheiro que o contacto tenha enviado anteriormente através do nó “Capture media” (descrito abaixo). Para isso, clique em “Add file”.
Um pedido envia um corpo ou um ficheiro, nunca ambos: o ficheiro substitui o corpo. Se “Add file” não estiver disponível, o nó já tem um corpo. Remova primeiro o corpo e depois adicione o ficheiro.
Em “File upload type”, escolha como o ficheiro é transferido:
- Form data with file: Escolha esta opção quando o sistema externo esperar um carregamento de ficheiro como o de um formulário web. O ficheiro é enviado como um campo do formulário. Em “Field name”, defina o nome desse campo. Se não indicar um nome, o campo chama-se “file”.
- Raw file content: Escolha esta opção quando o sistema externo esperar o próprio ficheiro como corpo do pedido. O tipo de ficheiro é enviado em conjunto.
Em “File”, introduza a ligação para um ficheiro externo ou clique em “Insert variable” no campo e selecione a variável em que o nó “Capture media” guardou o ficheiro. É o mesmo seletor de variáveis utilizado nos restantes campos do fluxo de trabalho. Se não for possível obter o ficheiro durante a execução, por exemplo, porque a variável está vazia, o pedido não é enviado e o fluxo segue a saída “If request failed”.
A área “Body” do nó na área de trabalho do fluxo mostra então o que é enviado: “JSON Body”, “Form data file” ou “Raw file”.
Capture carousel
Utilize este nó para permitir que o contacto escolha entre um número predefinido de opções, incluindo imagem e descrição, e para guardar temporariamente a escolha numa variável para utilização posterior na conversa. Utilize um texto alternativo caso as opções não possam ser apresentadas.
No nosso exemplo, é pedido ao contacto que escolha entre três opções. A escolha é guardada temporariamente na variável “option”. Se os botões não puderem ser apresentados, é mostrado o texto alternativo.
Capture regex
Utilize este nó para verificar se a introdução do cliente corresponde a um formato específico e predefinido. Pode encontrar alguns exemplos expandindo o ponto seguinte:
Exemplos de regex:
Capture buttons
Utilize este nó para permitir que o contacto escolha entre um número predefinido de opções e para guardar temporariamente a escolha numa variável para utilização posterior na conversa. Utilize um texto alternativo caso os botões não possam ser apresentados.
No nosso exemplo, é pedido ao contacto que escolha entre três opções. A escolha é guardada temporariamente na variável “option”. Se os botões não puderem ser apresentados, é mostrado o texto alternativo.
Capture email
Utilize este nó para pedir o endereço de e-mail do contacto e guardá-lo temporariamente numa variável para utilização posterior na conversa. Decida se pretende verificar se a variável já contém dados e se pretende permitir que o contacto ignore a introdução.
No nosso exemplo, é pedido ao contacto que introduza o seu endereço de e-mail. A resposta é guardada temporariamente na variável “email”. O sistema verifica se a variável já existe e está preenchida nos campos de contacto. O contacto não pode ignorar a introdução.
Capture media
Utilize este nó quando pretender que o contacto envie um documento num fluxo de trabalho. Escolha o tipo de documento (Image, Video, Audio, Document ou qualquer tipo).
No nosso exemplo, é pedido ao contacto que forneça um documento do tipo Image.
Utilize este nó quando pretender que o contacto envie um documento num fluxo de trabalho. Escolha o tipo de documento (Image, Video, Audio, Document ou qualquer tipo).
Se pretender utilizar o ficheiro mais tarde no fluxo de trabalho, introduza um nome em “Variable”, por exemplo, “photo”. O nó guarda então uma ligação para o ficheiro recebido nessa variável. Esta opção é facultativa.
Pode depois utilizar a variável em dois nós. Em ambos os campos, insira-a através de “Insert variable”, onde a encontra em “This Workflow”:
- Message: Clique em “Add media” e insira a variável no campo “URL” para enviar novamente o ficheiro ao contacto. O nó “Message” é descrito em [Nós gerais](https://docs.lime-connect.com/general-nodes-2c482b4dcc478116a022c5e7f0dda78e).
- API request: Insira a variável em “File” para enviar o ficheiro para um sistema externo (consulte a secção “API request” acima).
No nosso exemplo, é pedido ao contacto que forneça um documento do tipo Image.
A imagem é guardada na variável “photo”, para que possa ser enviada novamente ou encaminhada mais tarde no fluxo de trabalho.
Capture text
Utilize este nó para pedir qualquer texto ao contacto e guardá-lo temporariamente numa variável para utilização posterior na conversa. Decida se pretende verificar se a variável já contém dados e se pretende permitir que o contacto ignore a introdução.
No nosso exemplo, é pedido ao contacto que introduza o nome do seu animal de estimação. A resposta é guardada temporariamente na variável “pet-name”. O sistema verifica se a variável já existe e está preenchida nos campos de contacto personalizados. O contacto pode ignorar a introdução.
Capture text, Capture email, Capture regex e Capture media partilham a mesma definição para ignorar o passo. Ative “Optional” para permitir que os contactos o ignorem. Em “Skip button label”, introduza o texto do botão, por exemplo, “Skip”. A etiqueta pode ter até 20 caracteres e “Skip” é preenchido ao ativar “Optional”.
O contacto vê então o botão abaixo da sua mensagem e ignora o passo ao clicar nele. O fluxo segue a saída “When the input is skipped”. Se deixar “Skip button label” vazio, não é apresentado nenhum botão e os contactos só podem ignorar o passo introduzindo uma palavra-chave para o efeito, caso o fluxo de trabalho tenha essas palavras-chave.
O botão é apresentado no Website Messenger, WhatsApp e Facebook Messenger. Nos restantes canais, o contacto vê apenas a sua mensagem e só pode ignorar o passo introduzindo uma palavra-chave. A introdução de uma palavra-chave também permite ignorar o passo quando o botão é apresentado. Qualquer outro texto, incluindo “1”, é tratado como resposta à pergunta.
WhatsApp list
Utilize este nó para permitir que os seus contactos escolham uma opção de uma lista predefinida nos canais WhatsApp. Pode apresentar até 10 opções em formato de lista.
WhatsApp quick response
Este nó é utilizado de forma análoga ao nó “Capture buttons” quando pretende usar o chatbot em canais WhatsApp. Pode apresentar até 3 botões ou opções.
O que acontece quando um contacto responde com uma mensagem de voz?
Um contacto também pode responder a um nó em espera com uma mensagem de voz ou um ficheiro de áudio. O Lime Connect transcreve a gravação e o fluxo de trabalho utiliza o texto como se o contacto o tivesse escrito. A transcrição está ativa em todas as organizações, salvo se tiver sido desativada. O modo de desativá-la e a quantidade de áudio transcrita por dia são descritos na secção “Voice messages” do Message Center.
Como cada nó processa o texto de uma mensagem de voz:
- Capture text, Capture email e Capture regex: O texto é verificado como uma resposta escrita. Se for válido, o fluxo segue “If contact provided valid value” e guarda o texto na variável do nó. Caso contrário, segue “If contact provided invalid value”. Isto acontece, por exemplo, quando o contacto diz um endereço de e-mail em voz alta e o texto apresenta “name at example dot com” em vez de “name@example.com”.
- Capture buttons, Capture carousel, WhatsApp list e WhatsApp quick response: Uma mensagem de voz nunca seleciona uma opção, mesmo que o contacto diga o seu nome. O fluxo segue “If the contact does not respond or types any message”.
- Capture media: O texto não é utilizado e não pode ignorar este nó. A própria gravação conta como um ficheiro: o fluxo segue “If contact provided valid media” se o nó aceitar ficheiros de áudio e “If contact provided invalid media” se aceitar apenas outro tipo de ficheiro.
Se não for possível transcrever uma gravação, por exemplo, porque a transcrição falhou ou o limite diário foi esgotado, Capture text, Capture email e Capture regex seguem “If contact provided invalid value” e não guardam nada. Se essa saída não estiver ligada, o nó continua à espera. Os nós com opções continuam sempre à espera nesse caso. Se a transcrição estiver desativada para a sua organização, uma mensagem de voz não responde a estes nós e o nó continua à espera.
O texto responde apenas a um nó que já estava à espera quando o contacto enviou a mensagem de voz. Se o fluxo de trabalho tiver entretanto avançado, por exemplo, porque o contacto escreveu uma resposta antes de a transcrição estar pronta, o texto da mensagem de voz não é utilizado.