Trilha Técnica

Aqui fica o "manual interno" do Chatbot

Visão Interna do Serviço

Infraestrutura e Responsabilidade do Chatbot

Plataforma Base

O chatbot utilizado pela Nuvem JTI é baseado na plataforma fornecida pela Zpro.

A Zpro fornece:

Não é possível solicitar funcionalidades diretamente fora do roadmap oficial da plataforma.

Infraestrutura da Plataforma

Apesar da plataforma ser fornecida pela Zpro, a infraestrutura é responsabilidade da Nuvem JTI ou parceiros.

Inclui:

Esses serviços podem gerar cobrança adicional conforme fornecedor.

Servidores Atuais do Chatbot

chat2.ia.nuvemjti.com.br

Uso: Cliente Mais Cred
Hospedagem: Hostinger
Backup: Semanal automático pela Hostinger

chat.ia.nuvemjti.com.br

Uso: Todos os demais clientes
Hospedagem: Vultr
Backup: Diário automático pela Vultr

Regra obrigatória:
Antes de qualquer alteração na VPS, criar snapshot completo do servidor.

Servidor de Integrações de IA

Servidor: ia.nuvemjti.tec.br
Hospedagem: Hostinger

Utilizado para:

Esse servidor é parte crítica do ecossistema do chatbot.

Disparos em Massa e Campanhas

Para envio de campanhas ou disparos em massa, é necessário servidor dedicado.

Exemplo: uso do servidor chat2.

Essas funções normalmente ficam bloqueadas para clientes e só são liberadas com autorização do superior.

Integrações com WhatsApp e APIs

API Oficial da Meta

A API oficial do WhatsApp exige:

O processo é burocrático e depende de aprovação da Meta.

API Não Oficial

A Nuvem JTI utiliza a plataforma Uazapi em servidor dedicado.

Não utilizamos outras APIs não oficiais do chatbot para WhatsApp.

Outros Canais

Atualmente não homologados:

Esses canais podem ser avaliados futuramente.

API do Chatbot

O chatbot possui:

Existe documentação da API disponível via Postman.

Essa API permite:

Fluxos e Automação

Os fluxos podem ser criados de três formas:

Dependendo da integração, podem existir regras específicas de configuração.

Suporte com a Zpro

Quando ocorre problema na plataforma:

A Zpro pode orientar ou solicitar atualização do sistema.

Responsabilidade da Nuvem JTI

A Nuvem JTI é responsável por:

Limites da Nuvem JTI

A empresa não controla diretamente:

Nestes casos deve-se seguir o processo de escalonamento.

Pontos Críticos de Operação

Quando Utilizar Este Documento

Painel Administrativo

Onboarding + Criação de Ambiente do Cliente

Processo de Onboarding Chatbot - Comunicação com Cliente

Objetivo

Garantir uma comunicação clara, organizada e acolhedora durante todo o processo de implantação do chatbot.

O cliente precisa sentir que:

A comunicação faz parte da implantação tanto quanto a configuração técnica do chatbot.

Regra Principal de Comunicação com Cliente
Nunca fazer perguntas soltas ou sem contexto

Antes de perguntar qualquer informação ao cliente:

  1. valide internamente no card ou grupo;

  2. alinhe com a equipe;

  3. entenda exatamente a dúvida;

  4. só depois fale com o cliente trazendo contexto completo.

O cliente não conhece a estrutura interna do chatbot, fluxos ou automações.
Quando fazemos perguntas secas ou sem explicação, ele sente:

Forma ERRADA
Forma CORRETA

O Lucas me passou os dados iniciais da implantação do seu chatbot e alinhamos internamente a estrutura principal do atendimento.

Ficamos com uma dúvida em um ponto específico da operação:

Hoje quando o cliente entra em contato vocês preferem separar o atendimento por setor logo no início ou primeiro realizar uma triagem geral antes de direcionar?

Objetivo desse padrão

Essa abordagem:

Regra Interna Obrigatória

Discussões técnicas e dúvidas devem acontecer:

Nunca centralizar informação apenas no privado.

Caso exista conversa individual:

Princípios Obrigatórios de Comunicação
Sempre comunicar com contexto

Nunca envie apenas perguntas objetivas sem explicar o motivo.

Evitar:

Preferir:

O cliente precisa saber em que etapa está

Sempre mantenha o cliente atualizado sobre andamento, mesmo quando estiver aguardando informações, aprovações ou integrações.

Silêncio gera:

Mostrar alinhamento interno

Antes de perguntar algo ao cliente:

Comunicação Inicial Obrigatória
Ao iniciar a implantação

Exemplo:

Olá, sou NOME e faço parte do time de suporte e implantação da Nuvem JTI.

A partir de agora vou acompanhar a criação, configuração e treinamento do seu chatbot.

Vou te atualizando conforme avançarmos nas etapas para que você acompanhe toda a implantação.

Objetivo:

Validação Inicial – API Oficial Meta

Obrigatório validar logo no início da implantação

Quando o projeto utilizar API Oficial do WhatsApp/Meta, validar com o cliente:

Isso evita:

Forma ERRADA
Forma CORRETA

Para seguirmos com a ativação da API Oficial da Meta precisamos validar algumas informações da estrutura da conta.

Você possui uma conta Meta Business Manager com acesso administrativo?

Também vamos precisar de um cartão internacional para vinculação da cobrança oficial da Meta durante o processo de ativação da API.

Importante sobre cartão internacional
Explicar corretamente ao cliente

O cartão internacional:

Caso o cliente não possua estrutura Meta

Orientar com clareza:

Sem problemas.

Caso ainda não possua a estrutura Meta Business ou cartão internacional podemos te orientar durante essa etapa para organizar os acessos e seguir com a implantação corretamente.

Estruturação Inicial do Chatbot (geralmente já vem do comercial)
Durante levantamento das informações

O objetivo não é apenas “pegar dados”.

Precisamos entender:

Exemplo correto de levantamento

Estamos organizando a estrutura principal do seu chatbot para deixar o atendimento mais próximo da operação real da empresa.

Quais são hoje as dúvidas ou solicitações que vocês mais recebem no WhatsApp?

Nessas comunicações abaixo necessário sentir do cliente, pois tem alguns que não querem ficar recebendo updates apenas quer pronto
Aprovação de Fluxos e Mensagens
Nunca apenas enviar prints sem contexto

Evitar:

Preferir:

Finalizamos a primeira estrutura do fluxo principal do chatbot.

Organizamos o atendimento separando Comercial, Financeiro e Suporte para reduzir o tempo de resposta e facilitar o direcionamento do cliente.

Estou te enviando a estrutura para validação antes de seguirmos para os testes finais.

Integrações e Etapas Técnicas
Quando depender de terceiros ou APIs

Exemplo:

A integração do chatbot com o sistema externo já foi iniciada.

Agora estamos aguardando apenas a liberação/configuração da API para finalizar os testes completos.

Assim que tivermos retorno seguimos para a próxima etapa.

Durante testes
Sempre contextualizar

Evitar:

Preferir:

Finalizamos os testes internos do fluxo principal e agora precisamos validar o comportamento em uso real.

Quando puder, envie algumas mensagens no número do chatbot para verificarmos juntos se o direcionamento e respostas estão ocorrendo conforme esperado.

Comunicação Durante a Implantação
Sempre informar:
Modelo ideal de atualização

Finalizamos a configuração inicial dos fluxos e mensagens automáticas do chatbot.

Agora estamos ajustando os últimos detalhes de integração e validação dos atendimentos.

Após isso seguimos para os testes finais e treinamento da equipe.

Durante treinamentos e ajustes

Evitar:

Preferir:

Evitar
Nunca mandar:
Padrão Interno Obrigatório
Toda informação relevante deve:
Nunca:
Objetivo Final do Atendimento

O cliente deve sentir que:

O cliente não avalia apenas se o chatbot funciona.
Ele avalia principalmente a sensação de organização, segurança e acompanhamento durante toda a implantação.

---------------------------------

Processo de Criação da Plataforma Chatbot

Objetivo

Padronizar a criação da plataforma do cliente no Chatbot garantindo:

Toda implantação deve seguir este processo antes do treinamento e entrega ao cliente.

Regra Obrigatória Antes da Criação
Validar informações no card antes de iniciar

Antes de qualquer configuração:

Nunca iniciar criação “assumindo” informações.

Caso exista dúvida:

Organização de Arquivos
Criar pasta do cliente

Caminho:

OneDrive -> Produtos 06 -> Chatbot -> Dados Clientes

Procedimento

Dados Plataforma.txt

Seguindo o modelo padrão.

Levantamento Inicial
Validar no card do Planner

Etapa:

Criação do Chatbot

Identificar
Criação do Tenant
Acessar Super Admin

Criar novo Tenant com:

Motivo do +1
Usuário extra

Reservado para:

Canal extra

Reservado para:

Importante

Esse é o padrão atual, porém sempre validar:

Nunca assumir que o padrão atende todos os casos.

Criação do Usuário de Suporte
No Super Admin

Criar usuário do Suporte vinculado ao Tenant criado.

Acesso Inicial à Plataforma
Entrar no Chatbot

Utilizar:

Criação dos Usuários
Caminho

Administração -> Usuários

Configuração padrão do Tenant
Menus habilitados
Menus desabilitados
Importante sobre Disparo em Massa e Campanhas

Por padrão:

Motivo:

Regra Geral
Disparo e campanhas somente mediante validação

Liberar apenas:

Exceções

Alguns clientes específicos possuem liberação devido:

Exemplo:

Procedimento em caso de solicitação

Caso cliente solicite:

não habilitar diretamente.

Primeiro:

  1. alinhar com gestor;

  2. validar estrutura;

  3. validar impacto operacional;

  4. validar necessidade de servidor separado.

Canais Permitidos no Tenant
Manter habilitado
Demais canais

Os demais canais devem ser habilitados apenas conforme:

Nunca habilitar canais desnecessários apenas “por garantia”.

Criação das Filas
Caminho

Gestão Comercial -> Filas

Objetivo

Criar filas conforme:

Criação do Fluxo
Caminho

Automação -> Chat Flow

Recomendação

Preferencialmente utilizar:

Horário de Atendimento
Caminho

Gestão Comercial -> Horário de Atendimento

Configurar
Configurações Gerais
Caminho

Configuração -> Configurações -> Gerais

Manter habilitado
Configurações Obrigatórias
Configurar
Tipo de Listagem de Mensagens

Configurar:

Histórico Completo

Observação

Pode ser necessário alterar caso:

Bots e IA
Caminho

Configuração -> Configurações -> Bots e IA

Copiloto de IA
Caminho

Configuração -> Configurações -> Bots e IA -> Copiloto de IA

Manter configurado conforme padrão
Observação
Criação da Conexão Uazapi
Caminho

Administração -> Canais

Ao criar

Preencher apenas:

Padrão para nome do canal

Utilizar:

Objetivo:

Não preencher inicialmente
Após criar conexão

Editar conexão e habilitar:

Fechamento Automático
Configurar

Palavra-chave:

#sair

Criação da Conexão WhatsApp Oficial (WABA)
Caminho

Administração -> Canais

Preferência operacional

Preferencialmente criar utilizando:

Requisitos importantes

A linha:

Processo de ativação

Seguir o fluxo padrão de ativação utilizando:

Importante

A ativação deve ser realizada:

Objetivo desse procedimento

Garantir:

Após criar conexão

Editar conexão e habilitar:

DDD+Número - API Oficial

Fechamento Automático
Configurar

Palavra-chave:

#sair

Vinculação de Usuários
Caminho

Administração -> Usuários

Vincular
Observação

Administradores:

Revisão Obrigatória
Após finalizar toda configuração

Obrigatoriamente:

Não avançar para implantação ou treinamento sem validar
Caso informações estejam faltando

Entrar em contato com o cliente antes da implantação.

Forma ERRADA
Forma CORRETA

Estamos finalizando a estrutura operacional da sua plataforma e identificamos que ainda precisamos alinhar alguns pontos para deixar o atendimento configurado corretamente.

Precisamos validar:

Com isso conseguimos concluir a implantação e seguir para os testes e treinamento.

Objetivo Final

Ao finalizar a criação da plataforma:

Configurações Padrão

Configurações Avançadas

Erros Comuns

Diagnóstico de Problemas

Limites do Suporte

Quando e Como Escalar

Checklist - Onboarding Chatbot API Não Oficial (QR-CODE)

Meta Business (Whatsapp API Oficial + Coexistencia)

Como preparar seu WhatsApp para integração (passo a passo simples)

Pense nisso como dar acesso para nossa equipe configurar e cuidar do seu WhatsApp profissional com segurança.

1) Verificar se sua empresa já tem conta na Meta

Se você já anuncia no Instagram ou Facebook, provavelmente já tem.

✔️ Se já tiver, pode ir direto para o passo 4
❗ Se não tiver, siga os próximos passos

2) Ter um Facebook pessoal de alguém da empresa

Pode ser seu ou de um responsável.

👉 Pense nisso como o login principal que vai administrar tudo

3) Criar a conta da empresa na Meta

Acesse: https://business.facebook.com

👉 Aqui você cria o “painel da empresa”, como se fosse o CPF/CNPJ dentro do sistema da Meta

4) Convidar a Nuvem JTi

Adicionar o e-mail:
bruno.galzerano@nuvemjti.com.br

👉 Isso é como dar acesso para nossa equipe configurar tudo para você, sem precisar compartilhar senha

5) Validar sua empresa

A Meta pode pedir alguns dados (CNPJ, endereço, etc.)

👉 É como uma confirmação de que sua empresa é real

6) Cadastrar um cartão de crédito internacional

👉 Esse cartão é usado pela Meta para cobranças (como envio de mensagens)

Pense como:

7) Criar ou vincular seu WhatsApp

Aqui você pode:

👉 Esse é o momento de “plugar” o WhatsApp no sistema