Configurações

A página de Configurações é organizada em abas:

Conta

• Nome da empresa — Identificação do tenant
• Fuso horário — Para agendamentos e relatórios
• Idioma — Português, English, Español

Contas WhatsApp

• Lista de contas conectadas (Baileys e Cloud API)
• Status de conexão em tempo real
• Botão para reconectar contas desconectadas
• Adicionar nova conta

Integrações

• Instagram — Conecte páginas do Instagram Business para DMs
• Messenger — Conecte páginas do Facebook para Messenger
• Widget — Configure o widget de chat para seu site
• API Tokens — Gere tokens para integrações via API

Widget de Chat

Configure o widget embarcável para seu site:

• Cor primária — Cor do botão e header
• Mensagem de boas-vindas — Texto inicial
• Posição — Canto inferior direito ou esquerdo
• Código de instalação — Copie o script para seu site

Billing (Faturamento)

• Plano atual e recursos incluídos
• Uso de tokens de IA
• Botão para upgrade de plano
• Histórico de faturas

IA

• Modelo padrão — Modelo LLM default para agentes
• Temperatura padrão — Criatividade default
• Max tokens padrão — Limite default

NPS

• Configurações gerais de pesquisa NPS
• Tipo de escala padrão
• Mensagem de agradecimento

O Widget de Chat permite adicionar um chat ao vivo no seu site que se conecta ao WhatsApp.

Instalação

1. 1Vá em Configurações > Integrações > Widget
2. 2Configure as opções visuais (cor, posição, mensagem)
3. 3Copie o código de instalação
4. 4Cole o script antes do no HTML do seu site:

<script src="https://widget.zivlo.com.br/widget/zivlo-widget.js"
  data-api-key="SUA_API_KEY">
</script>

Preview

Antes de instalar, visualize como ficará em Widget > Preview ou acesse /widget/preview/:apiKey.

Funcionalidades

• Chat em tempo real via WebSocket
• Envio de texto e anexos
• Histórico de conversas preservado
• Design responsivo (mobile e desktop)
• Personalização de cores e posição

Conecte seu perfil Instagram Business ao Zivlo para receber e responder DMs diretamente no inbox unificado, com automações e IA.

Pré-requisitos

• Conta Instagram Business ou Creator (contas pessoais não são suportadas)
• Perfil Instagram vinculado a uma Página do Facebook (obrigatório pela Meta)
• Acesso de administrador na Página do Facebook vinculada
• Conta Meta/Facebook com permissão para gerenciar o app

Como converter para conta Business

Se você ainda tem uma conta pessoal:

1. 1Abra o app do Instagram e vá em Configurações > Conta
2. 2Toque em "Mudar para conta profissional"
3. 3Escolha Business (empresa) ou Creator (criador de conteúdo)
4. 4Vincule à uma Página do Facebook (crie uma se necessário)

Passo a passo da conexão

1. 1No Zivlo, vá em Configurações > Integrações
2. 2Clique no botão "+ Adicionar conta"
3. 3Selecione o tipo Instagram
4. 4Clique em "Login com Meta"
5. 5Você será redirecionado para o login da Meta
6. 6Faça login com sua conta Facebook/Meta
7. 7Selecione o perfil Instagram que deseja conectar
8. 8Autorize as permissões solicitadas:

- instagram_business_basic — acesso ao perfil

- instagram_business_manage_messages — ler e enviar DMs

- instagram_business_manage_comments — gerenciar comentários

- instagram_business_content_publish — publicar conteúdo

- instagram_business_manage_insights — métricas do perfil

1. 1Após autorizar, você será redirecionado de volta ao Zivlo
2. 2A conta Instagram aparecerá na lista de integrações com status Conectado

O que funciona após conectar

• DMs do Instagram aparecem automaticamente no inbox unificado
• Automações criadas no Flow Builder funcionam no Instagram automaticamente
• Agentes IA respondem DMs do Instagram com o mesmo contexto
• Atribuição de equipe funciona normalmente (atribuir a agente/time)
• Conversas mostram o ícone 📸 indicando que vieram do Instagram

Limitações

• Apenas DMs são recebidos (comentários em posts são tratados separadamente)
• Stories replies aparecem como DMs normais
• A API da Meta tem um limite de 24h para responder: mensagens recebidas precisam ser respondidas dentro de 24 horas, caso contrário a janela se fecha
• Mídias (imagens, vídeos, áudios) enviadas pelo Instagram são recebidas normalmente

Solução de problemas

Conecte suas Páginas do Facebook ao Zivlo para receber e responder mensagens do Messenger no inbox unificado.

Pré-requisitos

• Uma Página do Facebook (não perfil pessoal)
• Acesso de administrador na página
• Conta Meta/Facebook ativa

Passo a passo da conexão

1. 1No Zivlo, vá em Configurações > Integrações
2. 2Clique no botão "+ Adicionar conta"
3. 3Selecione o tipo Messenger
4. 4Clique em "Conectar com Facebook"
5. 5Você será redirecionado para o login do Facebook (OAuth)
6. 6Faça login com sua conta Facebook
7. 7O Zivlo solicitará as seguintes permissões:

- pages_messaging — enviar e receber mensagens pela página

- pages_show_list — listar suas páginas

- pages_manage_metadata — gerenciar metadados da página

- pages_read_engagement — ler engajamento da página

1. 1Após autorizar, uma lista das suas Páginas do Facebook será exibida
2. 2Selecione a página que deseja conectar ao Messenger
3. 3Clique em "Conectar"
4. 4O Zivlo automaticamente:

- Faz o subscribe dos webhooks da página

- Registra a conta como integração do tipo Messenger

- Ativa o recebimento de mensagens

1. 1A página aparecerá na lista de integrações com status Conectado

O que funciona após conectar

• Mensagens do Messenger aparecem automaticamente no inbox unificado
• Automações do Flow Builder funcionam no Messenger
• Agentes IA respondem mensagens do Messenger
• Atribuição a agentes e times funciona normalmente
• Conversas mostram o ícone 💬 indicando que vieram do Messenger
• Campanhas podem ser acionadas por respostas vindas do Messenger

Diferenças entre Instagram e Messenger

Múltiplas páginas

Você pode conectar várias Páginas do Facebook ao Zivlo. Cada página será uma integração separada, e as mensagens de cada uma aparecerão no inbox com identificação da página de origem.

Solução de problemas