Bots que usam seus próprios sistemas e documentos
Opcional: um bot pode consultar dados (status de fatura, pedido) no seu sistema e enviar documentos como um PDF de fatura — aqui está o que a OmniBrand precisa de você.
Esta é uma parte opcional de um bot. Engenheiros da OmniBrand configuram para você mediante solicitação; não há nada para configurar no seu espaço de trabalho.
O que ela pode fazer
- Envie seus documentos padrão: um perfil da empresa, uma lista de preços, um cardápio, um folheto — arquivos que você mantém online. Você dá a cada um um nome e um link; o bot envia o que o cliente pede.
- Procure dados no seu sistema enquanto conversa: o cliente fornece, por exemplo, uma fatura ou número de pedido, o bot pergunta ao seu sistema e responde — "Fatura 204 foi paga", "Seu pedido está em entrega".
- Envie um documento que seu sistema produz, como o PDF dessa fatura, usando o link que seu sistema retorna.
- Envie as respostas coletadas para seu sistema, por exemplo, para criar um lead no seu CRM.
O documento chega como arquivo no chat: no WhatsApp como mensagem de documento, por e-mail como anexo, e no chat do site como um arquivo que o visitante pode abrir. No tópico da sua caixa de entrada, a mensagem do bot mostra o nome do arquivo com 📄.
O que a OmniBrand precisa de você
Para documentos padrão:
- O nome de cada documento como os clientes vão pedi-lo, e um link para o arquivo que comece com
https://e possa ser baixado sem login. No WhatsApp, no Instagram e no Messenger, o serviço de mensagens busca o arquivo nesse link; para e-mail e chat do site, o OmniBrand o baixa (no máximo 25 MB) e o envia a partir do próprio armazenamento.
Para consultar dados no seu sistema:
- O endereço (URL) do serviço no seu sistema que responde a uma pergunta, começando com
https://— por exemplo,https://erp.example.com/api/invoices/{number}, com o local onde vai o valor do cliente. - Se é chamado com GET ou POST.
- A credencial: uma chave ou token da API, e o nome do cabeçalho em que ele vai (geralmente
Authorization). Envie pelo canal que o suporte lhe fornece, não em uma mensagem pública. - Um valor de teste que existe e outro que não existe (por exemplo, um número real de fatura e um inventado), para que os engenheiros possam testar com seus dados reais antes de serem lançados.
- Uma breve descrição da resposta: quais campos ela contém (por exemplo,
status,amount,pdf_url) e quais deles o bot pode informar ao cliente. - Como seu sistema diz "não encontrado": ele deve responder com o status HTTP 404. Qualquer outro erro é tratado como "o sistema não está disponível".
- O que o cliente deve dar para provar quem é antes que o bot revele dados (por exemplo, o número de telefone na fatura), para que o bot peça por isso.
Como seus dados são protegidos
- Apenas endereços https são aceitos.
- Sua credencial é armazenada criptografada. Após ser salva, a equipe da OmniBrand vê apenas seus últimos quatro caracteres; ela é adicionada apenas à solicitação ao seu sistema e nunca é mostrada aos clientes.
- Os valores que os clientes digitam são codificados com segurança no endereço; com POST, eles são enviados como JSON.
- Os servidores do OmniBrand se recusam a chamar endereços de rede internos ou privados, e verificam de novo cada redirecionamento. Quando o seu sistema redireciona para outro endereço, a sua credencial não é enviada para lá.
- Cada chamada espera no máximo 10 segundos e lê no máximo 256 KB da resposta.
- Cada alteração nessas conexões e cada teste é registrado com o nome do engenheiro que realizou.
Se seu sistema não responder
Quando o seu sistema está fora do ar, lento, responde "não encontrado" ou retorna um erro, o bot segue o caminho definido para esse caso — por exemplo "Não encontramos essa fatura" — ou transfere a conversa para a sua equipe com uma nota como "Nothing found in invoices." ou "The invoices data source failed: …" (cada uma com a linha em árabe abaixo). Os seus clientes nunca ficam sem resposta.
Se um documento não puder ser baixado pelo link (para e-mail e chat do site: não é um link https público, ou tem mais de 25 MB), o bot transfere a conversa para a sua equipe com a tag bot-error e uma nota que indica o documento.