Enviar Mensagem
- 1.1 Enviar texto / Variável
- 1.2 Inserir valor de campo personalizado e emoji
- 1.3 Enviar Imagem / Áudio / Vídeo / Arquivo
- 1.4 Enviar cartão
- 1.5 Enviar Loop "Para Cada"
- 1.5.1 Valor na variável JSON:
- 1.5.2 Valor na variável "ITEM":
- 1.5.3 Opções de Formatação de valor
- 1.5.3.1 Chaves Ocultas
- 1.5.3.2 Exemplo de INDEX
- 1.5.3.3 Exemplo de KEY/VALUE
- 1.6 Enviar SELECT após "Para Cada"
- 1.7 Enviar conteúdo dinâmico
- 1.8 Enviar localização
- 1.9 Enviar produto de comércio eletrônico
- 1.10 Enviar mensagem de depuração de texto
- 2 Canais do Facebook
- 3 Canal do WhatsApp
- 3.1 Enviar mensagem
- 4 Canal SMS
- 4.1 Enviar mensagem
- 5 Canal de Voz
Depois de criar seu primeiro fluxo, abra-o, clique em "Editar fluxo", coloque seu bot lado a lado e pronto! 😆
Vamos pegar o Facebook como exemplo. Outros fluxos compartilham processos similares onde a principal diferença é o tipo de mensagem.
Alguns passos simples para enviar sua primeira mensagem:
clique no ponto inicial verde
no painel de edição, "Selecione a próxima etapa"
escolha a etapa "Enviar mensagem"
clique no passo "Enviar mensagem"
clique em texto digite mensagem
digite sua mensagem
"Publicar"
É isso! Vamos testar!
Clique em "Visualizar" na barra de navegação e "Abrir o fluxo no Messenger". Clique em "Começar" se for a primeira vez que você fala com o bot.
Recurso de visualização - Observe que o recurso "Visualizar" não é suportado em todos os canais. Os canais suportam "Visualizar": Facebook, Telegram, WhatsApp, Line e Viber. Para canais sem Visualizar , pesquise "falar com bot" na documentação para obter orientação.
Parabéns! Seu bot está funcionando agora. 🤖🤖
Deixe-me mostrar mais alguns detalhes sobre a etapa Enviar mensagem. Esses são os tipos de mensagem em comum para todos/alguns dos canais.
Enviar texto / Variável
O WiiChat foi integrado ao Grammarly para ajudar você a obter uma expressão perfeita.
Inserir valor de campo personalizado e emoji
Onde quer que você veja "</>", você pode inserir emojis ou valores variáveis no texto
Ou simplesmente digite "{{" para chamar a lista de campos:
Enviar Imagem / Áudio / Vídeo / Arquivo
Existem 4 maneiras no total:
carregue do seu computador ( tamanho limitado )
Tipo de mídia | Tamanho máximo de upload |
---|---|
vídeo | 10MB |
áudio | 5MB |
arquivo | 5MB |
outros (por exemplo, imagem) | 2MB |
De um link de URL (recomendado)
Você pode pesquisar imagens on-line e copiar seus links de URL diretos. Mas esse link direto pode mudar. Como alternativa, você pode carregar fotos para seu servidor ou outros armazenamentos de fotos de terceiros, como Imgur:, e obter seus links de URL diretos a partir daí. Link de URL direto significa que o link está apontando para uma foto específica, não para um site, terminando com .jpg ou .png, etc. Veja o link na imagem acima como exemplo.
pesquisar na galeria de GIFs
O WiiChat fornece uma galeria de GIFs, você pode pesquisar o que precisa aqui.
da Biblioteca
A Biblioteca é o lugar onde você pode ver todas as fotos, GIFs, áudios e vídeos que você carregou antes. Para que você não precise carregar novamente a mesma mídia, basta encontrá-la na sua biblioteca.
Enviar cartão
O cartão é usado para exibir uma série de informações de forma agradável, como informações de produtos. Há 4 fatores em um cartão: imagem, título, subtítulo e botão.
Observe que para exibir um card, você deve ter um título e pelo menos um outro fator, imagem, subtítulo ou botão.
Se você quiser enviar um cartão no canal do WhatsApp, você precisará criar um “Modelo de carrossel” e então usar “Modelo de carrossel”.
Enviar Loop "Para Cada"
Este tipo de mensagem também mostra cards, mas de uma forma mais automática. Com "Para Cada", você não precisa digitar cada card você mesmo. Ele exibe automaticamente todos os itens em uma variável JSON. Verifique Action Step - JSON Operation se você não tem ideia sobre o que é variável JSON.
Primeiro escolha uma variável JSON contendo os seus dados e valores desejados
Segundo clique em "</>" ou digite "{{" na caixa de texto
Terceiro escolha o campo "ITEM" para obter um item de amostra da variável JSON
Valor na variável JSON:
Valor na variável "ITEM":
Os "Dados de amostra" são para preencher rapidamente o campo "Caminho JSON". Por exemplo, como mostrado na imagem, clique na linha "preço" e "$.price" aparece no próprio "Caminho JSON". Isso significa que estamos exibindo o preço de cada item aqui. Se não houver dados de amostra solicitados, você mesmo pode preencher o caminho digitando "$.", que se refere a cada item na variável JSON, seguido pela chave de um valor.
Opções de Formatação de valor
Além disso, para números como porcentagem e preço, para valor de data e valor de tempo, o WiiChat tem diferentes formatos listados para você. Por exemplo, na imagem acima, o valor do preço é "5" e após escolher um formato "F03", o bot o exibirá como "$5". Enquanto o valor na variável ainda é o número "5", para que você possa usá-lo em cálculos matemáticos ou comparação de condições sem mau funcionamento.
Chaves Ocultas
Ótimo! Agora você vê como usar o "Para Cada". Além das chaves na variável JSON, há 3 chaves ocultas que você pode precisar:
Nome da chave | Descrição |
---|---|
INDEX | índice do item começou em 1 |
KEY | nome da chave do item |
VALUE | valor do item = o item em si |
Exemplo de INDEX
Quando você tem um JSON com uma lista de JSONs nele, use INDEX para verificar o número de sequência de um item. Vamos adicionar um número de índice antes do nome do item:
Resultado do teste:
Exemplo de KEY/VALUE
Quando você tem um JSON como mostrado na imagem a seguir, em vez de um JSON contendo uma lista de JSONs,
Isto é o que você obterá ao usar as três chaves:
Resultado do teste:
Enviar SELECT após "Para Cada"
Quando você adiciona um botão ao seu "Para Cada", o botão vai aparecer com cada cartão. Normalmente, você pode querer colocar um botão "Comprar" ou "Selecionar" aqui no caso de estar listando alguns produtos ou opções.
Como o bot sabe qual carta o usuário selecionou?
Ao selecionar a próxima etapa para o botão, escolha "Selecionar":
Em seguida, selecione um próximo passo como você normalmente faz, como um Send Message Step para mostrar o item selecionado ou Action Step para lidar com os dados. Você pode então acessar o item selecionado em "SELECT":
Por exemplo, vamos adicionar uma etapa Enviar Mensagem, localize o campo do sistema "SELECT":
clique na linha "item" para obter o caminho "$.item" ou digite o caminho diretamente
no caminho JSON, adicione o nome da chave se necessário. Neste caso, vamos mostrar o nome do item selecionado. Então adicione ".name" depois do caminho.
Você verá isso quando testar:
Enviar conteúdo dinâmico
O Conteúdo Dinâmico ajuda você a enviar uma solicitação de API para seu servidor ou um servidor de terceiros, a fim de obter uma resposta para exibição. O servidor pode responder de forma diferente a cada vez. Dessa forma, seu bot é capaz de exibir conteúdo dinâmico para seus usuários.
Esse recurso é prático quando a lógica do seu bot é complexa e depende muito de outros servidores.
Por exemplo, você tem seu próprio algoritmo de IA para analisar as perguntas dos usuários e calcular a resposta correspondente no seu servidor, neste caso, você pode enviar a pergunta na solicitação da API. E o servidor pode gerar uma resposta com base na pergunta. Finalmente, o servidor envia a resposta de volta ao WiiChat para exibir aos seus usuários.
Uma mensagem de resposta pode conter várias mensagens, botões e respostas rápidas com ações. Você pode até aplicar ações simples como adicionar tag diretamente no JSON de resposta.
Verifique a etapa de ação - Solicitação externa para saber como enviar uma solicitação de API,
e Formato de Resposta para orientação sobre formatação de mensagens.
Enviar localização
Para enviar uma localização, pesquise-a em um mapa e clique com o botão direito do mouse para copiar seus valores de latitude e longitude:
Insira o nome do seu local, cole os dados e adicione um rótulo, se necessário. Um rótulo fornece informações adicionais, como andar ou número da sala.
Enviar produto de comércio eletrônico
Consulte o Ecommerce para saber como configurar e usar o sistema de e-commerce integrado.
Enviar mensagem de depuração de texto
O recurso Enviar mensagem de depuração foi projetado para facilitar a depuração para criadores de chatbots, fornecendo uma maneira fácil de enviar mensagens de depuração especificamente para testadores.
Acessando o texto de depuração:
Navegue até Enviar mensagem e selecione Depurar texto
Adicionando testadores:
Navegue até Ferramentas -> Testadores-> Novo Testador
Identifique o(s) usuário(s) que servirão como testadores do seu chatbot.
Adicione o(s) usuário(s) à lista de testadores.
Enviando mensagens de depuração:
Depois que os testadores forem adicionados, acione a visualização do fluxo onde você incorporou o Texto de depuração de envio de mensagem.
Durante a visualização, o texto de depuração ficará visível para os testadores adicionados.
Canais do Facebook
Enviar mensagem
O Facebook permite que o bot envie mensagens de texto com 3 botões e no máximo 10 respostas rápidas.
Enviar texto com botão e resposta rápida
A diferença entre botão e resposta rápida no Facebook Messenger:
Tipo | Uso |
---|---|
botão | uma vez enviado, sempre na conversa para ser pressionado |
resposta rápida | semelhante ao botão, mas desaparece quando usado |
Tente adicionar alguns botões, respostas rápidas e teste. Você verá as diferenças.
Canal do WhatsApp
Enviar mensagem
Tipos de mensagens com WhatsApp:
O botão no WhatsApp é um pouco diferente do do Facebook. Um botão no Facebook pode ser pressionado várias vezes, enquanto no WhatsApp, apenas uma vez.
Tipos de mensagens suportados
O UChat suporta o envio dos seguintes tipos de mensagens do WhatsApp:
Template Message: Mensagens predefinidas aprovadas pelo WhatsApp. Os usuários podem criar novos modelos diretamente no UChat ou sincronizar modelos aprovados existentes.
Single Product Message: Exibe um único produto de um catálogo do Facebook. Requer um ID de catálogo do Facebook e um ID de varejo.
Multiple Products Message: Exibe até 30 produtos de um catálogo do Facebook. Requer um ID de catálogo do Facebook e separa os produtos com vírgulas.
Mensagem do catálogo: exibe uma lista de produtos de um catálogo do Facebook. Requer um ID de varejo, corpo de texto e rodapé.
List Message: Apresenta uma lista de opções para os usuários escolherem. Requer capturar a seleção do usuário e direcionar o fluxo com base na opção escolhida.
Fluxo do WhatsApp: crie um fluxo do WhatsApp para automatizar o envio de mensagens e interações com usuários.
Observação : vincular seu número do WhatsApp ao seu catálogo do Facebook é obrigatório para enviar mensagens relacionadas a produtos (produto único, vários produtos e mensagem de catálogo).
Enviando uma mensagem de modelo
Criar ou sincronizar modelo: na seção Conteúdo do bot do UChat, você pode criar um novo modelo diretamente em "Modelos de mensagem" no UChat ou sincronizar modelos aprovados existentes clicando no botão "Sincronizar".
Uso no fluxo: No "nó Mensagem", selecione "Outros" e "Mensagem de modelo (WhatsApp)" no seu fluxo do UChat.
Selecionar modelo: escolha o modelo desejado no menu suspenso.
Personalizar (opcional): se o modelo incluir variáveis, você poderá personalizar o conteúdo da mensagem.
Enviando mensagens de produtos individuais
Requisito do catálogo do Facebook: você precisa de um catálogo do Facebook para esses tipos de mensagens.
Uso no fluxo: No "Nó de mensagem", selecione "Outros" e "(WhatsApp) Produto único" no seu fluxo do UChat.
ID do catálogo e ID de varejo:
Localize seu ID do catálogo do Facebook.
Identifique o ID de varejo, que é o ID de conteúdo do feed do seu catálogo de produtos.
Insira as informações da sua mensagem: forneça o ID de varejo, o texto do corpo da mensagem e o texto do rodapé da sua mensagem do catálogo.
Observação: você precisa vincular seu número do WhatsApp ao seu catálogo do Facebook antes de enviar mensagens sobre produtos.
Enviando várias mensagens de produtos
Requisito do catálogo do Facebook: você precisa de um catálogo do Facebook para esses tipos de mensagens.
Uso no fluxo: No "Nó de mensagem", selecione "Outros" e "(WhatsApp) Vários produtos" no seu fluxo do UChat.
ID do catálogo e ID de varejo:
Localize seu ID do catálogo do Facebook.
Identifique o ID de varejo, que é o ID de conteúdo do feed do seu catálogo de produtos.
Insira as informações da sua mensagem: forneça o ID de varejo, o texto do corpo da mensagem, o texto do cabeçalho e do rodapé da sua mensagem do catálogo.
Observação: você precisa vincular seu número do WhatsApp ao seu catálogo do Facebook antes de enviar mensagens sobre produtos.
Enviando uma mensagem de catálogo
Uso no fluxo: No "nó de mensagem", selecione "Outros" e "Mensagem do catálogo (WhatsApp)" no seu fluxo do UChat.]
ID do catálogo e ID de varejo:
Localize seu ID do catálogo do Facebook.
Identifique o ID de varejo, que é o ID de conteúdo do feed do seu catálogo de produtos.
Insira as informações da sua mensagem: forneça o ID de varejo, o texto do corpo da mensagem e o texto do rodapé da sua mensagem do catálogo.
Enviando uma mensagem de lista
Uso no fluxo: No "nó Mensagem", selecione "Outros" e "Mensagem da lista (WhatsApp)" no seu fluxo do UChat.
Definir itens da lista: selecione os itens da lista que você deseja incluir na sua mensagem da lista.
Capturar seleção do usuário: é crucial capturar a opção escolhida pelo usuário na lista.
Roteamento condicional: use um bloco de condição para verificar a seleção do usuário e direcionar o fluxo adequadamente.
Observação: as etapas 2 a 4 para mensagens de lista são essenciais para garantir o fluxo adequado com base na interação do usuário.
Enviando uma mensagem do WhatsApp Flow
Uso no fluxo: No "nó de mensagem", selecione "Outros" e "(WhatsApp Cloud) WhatsApp Flow" no seu fluxo do UChat.
Defina o fluxo do WhatsApp a ser enviado.
Observação: consulte a documentação de criação do WhatsApp Flow aqui:
Aviso: Não use o nó de ação para enviar modelos para usuários de bot, isso gerará um erro de "ação proibida". Para fazer isso, use o nó de mensagem.
Canal SMS
Enviar mensagem
O bot de SMS pode enviar apenas texto e imagem.
Canal de Voz
Enviar mensagem
Enviar texto/áudio
Você pode fazer com que o bot leia o texto em um idioma específico ou gravar seu próprio áudio e enviá-lo.
No canal de voz, você também pode fornecer uma URL de áudio diretamente no nó de envio de mensagem.
Você precisa ter certeza de que a URL do áudio é acessível publicamente, ela deve começar com https e terminar com .mp3
Você também pode usar a mesma URL de áudio diretamente no nó da pergunta.
Observação - Para o bot de voz, você pode definir um idioma padrão no Ponto de Início Verde ou defini-lo separadamente para cada etapa de envio de mensagem/pergunta.
O WiiChat construiu um Mini-App chamado "VoiceMaker" usando uma API de terceiros que fornece a você uma melhor qualidade de conversão de texto para voz! Baixe o Mini-App na seção de integração. A documentação sobre o "VoiceMaker" está em andamento.
Google Meu Negócio - Enviar Mensagem
Tipos de mensagens com o fluxo do Google Meu Negócio:
Todos os tipos são abordados acima, por favor, verifique o tipo de mensagem em comum para todos/alguns canais. Encontre o tipo de localização em "Rich Media".