Skip to main content

​
O que é a tela Apps

Quem usa: Administrador. A aba Apps é onde cada tenant pode cadastrar suas próprias credenciais para redes sociais e marketplaces, substituindo a configuração Global mantida pelo Super Administrador da plataforma. Se o tenant não cadastrar nada aqui, o sistema simplesmente usa a configuração Global: ou seja, muitas dessas integrações já funcionam de fábrica, sem nenhuma ação do administrador do tenant. Como acessar: menu Configurações → Apps. As páginas cobertas nesta aba são: LinkedIn, Mercado Livre, OLX, Rocket.Chat, TikTok, WooCommerce, Nuvemshop, Google (beta) e YouTube, detalhadas a seguir.
Esta tela é o pré-requisito de credenciais para conectar os canais correspondentes de marketplace e redes sociais. Ela precisa estar configurada (ou já disponível de forma global pela plataforma) antes de criar um canal desses tipos em Administração > Canais > Adicionar Canal, conforme descrito na página “Outros Canais”.
Todas as integrações desta aba estão atualmente em fase beta: foram lançadas recentemente e ainda estão em testes e ajustes, podendo apresentar instabilidade ou comportamento inesperado em alguns cenários. Recomenda-se reportar qualquer problema ao suporte para que seja corrigido nas próximas versões.

​
Apps disponíveis

Quem usa: Administrador.O que é: página que permite ao tenant configurar suas próprias credenciais OAuth do LinkedIn, substituindo a configuração global definida pelo Super Administrador. É usada para responder comentários e gerenciar a presença da empresa no LinkedIn pelo PanÐá Zap.Passo a passo:
  1. Acesse Configurações → Apps → LinkedIn.
  2. Certifique-se de que sua empresa já obteve aprovação do programa Community Management no LinkedIn Developer Portal: sem essa aprovação, a integração não funciona, independentemente das credenciais configuradas.
  3. Clique em + Novo App LinkedIn.
  4. Preencha o App ID (client_id) e o App Secret (client_secret) obtidos no LinkedIn Developer Portal.
  5. Copie o Redirect URI (OAuth callback) e cadastre-o exatamente assim no LinkedIn Developer Portal. O Webhook URL também é um campo fixo e não pode ser alterado.
  6. Preencha uma Descrição opcional (ex.: “App LinkedIn principal”) e ative o toggle Ativo.
Benefícios e quando usar: use credenciais próprias quando quiser isolar o app LinkedIn da sua empresa do app compartilhado padrão da plataforma, por exemplo por exigência de compliance interna ou para ter limites de uso de API dedicados.
Respostas a comentários são públicas e visíveis no LinkedIn: toda resposta enviada pelo PanÐá Zap aparece publicamente no post. Oriente a equipe a responder de forma adequada ao contexto público da rede social.
Ao cadastrar credenciais aqui, o tenant passa a usar as próprias credenciais em vez das configuradas pelo Super Administrador; sem configuração nesta página, o sistema usa a configuração Global. O token do LinkedIn expira a cada 60 dias e é renovado automaticamente pelo PanÐá Zap: nenhuma ação manual é necessária.
Quem usa: Administrador.O que é: página que permite ao tenant configurar suas próprias credenciais OAuth do Mercado Livre, substituindo a configuração global do Super Administrador. É usada para atender consultas e vendas feitas pelo Mercado Livre diretamente no PanÐá Zap.Passo a passo:
  1. Acesse Configurações → Apps → Mercado Livre. A listagem mostra os apps já configurados (colunas ID, App ID, Site, Descrição, Status).
  2. Clique em + Novo App ML.
  3. Preencha o App ID (client_id) gerado no portal de desenvolvedores do Mercado Livre.
  4. Selecione o Site ID: o país de operação (ex.: Brasil = MLB, Argentina = MLA, México = MLM).
  5. Preencha o App Secret (client_secret).
  6. Copie o Redirect URI (OAuth callback) e cadastre-o exatamente assim no DevCenter do Mercado Livre. O Webhook URL também é fixo e não pode ser alterado.
  7. Informe uma Descrição opcional e ative Ativo.
Benefícios e quando usar: indicado para empresas que vendem no Mercado Livre e querem centralizar as mensagens de compradores no mesmo painel de atendimento usado para WhatsApp e demais canais.
O Redirect URI precisa ser cadastrado exatamente como https://oauth.techprovider.com.br/callback.html no DevCenter do Mercado Livre: qualquer divergência impede o funcionamento da integração.
Configuração aqui sobrescreve a Global; sem configuração nesta página, usa-se a Global definida pelo Super Admin.
Quem usa: Administrador.O que é: página que permite ao tenant configurar suas próprias credenciais OAuth da OLX, substituindo a configuração global do Super Administrador.Passo a passo:
  1. Acesse Configurações → Apps → OLX e clique em + Novo App OLX.
  2. Preencha o Client ID e o Client Secret: ambos fornecidos pela OLX por e-mail, mediante solicitação.
  3. Ao solicitar as credenciais à OLX (contato: suporteintegrador@olxbr.com), informe exatamente o Redirect URI (OAuth callback) fixo do sistema: https://oauth.techprovider.com.br/callback.html. O Webhook URL também é fixo (https://oauth.techprovider.com.br/olx-webhook) e não pode ser alterado.
  4. Informe uma Descrição opcional e ative Ativo.
Benefícios e quando usar: indicado para empresas que anunciam e vendem pela OLX e querem tratar as mensagens de interessados no mesmo painel de atendimento.
Tokens OLX não possuem renovação automática. Quando o token expirar, o canal ficará desconectado e será necessário refazer a autenticação OAuth no painel admin manualmente, diferente do LinkedIn, por exemplo, que renova sozinho.
Qualquer divergência no Redirect URI informado à OLX impede o funcionamento da integração.
Quem usa: Administrador.O que é: página que permite ao tenant configurar suas próprias credenciais de servidor Rocket.Chat, substituindo a configuração global do Super Administrador. É o complemento técnico da tela Habilitar Rocket.Chat (seção Integrações): lá se liga/desliga a visibilidade para os agentes, aqui se define qual servidor Rocket.Chat será usado.Passo a passo:
  1. Acesse Configurações → Apps → Rocket.Chat e clique em + Novo App RC.
  2. Informe a URL do servidor (ex.: https://chat.suaempresa.com).
  3. Gere, no próprio Rocket.Chat, em Perfil → Tokens de Acesso Pessoal, o Admin User ID (X-User-Id) e o Admin Auth Token (X-Auth-Token), e cole-os nos respectivos campos.
  4. Informe uma Descrição opcional.
  5. Ative Criar usuários automaticamente se quiser que o sistema crie automaticamente uma conta no Rocket.Chat para cada agente que acessar o chat pela primeira vez.
  6. Ative Ativo e salve.
  7. Vá em Configurações → Integrações → Rocket.Chat, ative o toggle Habilitar Rocket.Chat e salve novamente. Só então os agentes conseguem acessar o chat em Comunicação e Marketing → Redes Sociais → Rocket.Chat.
Benefícios e quando usar: use quando sua empresa já mantém (ou quer manter) seu próprio servidor Rocket.Chat, em vez de usar o servidor padrão fornecido pela plataforma.
Importante: salvar esta configuração não ativa automaticamente o Rocket.Chat para os agentes. É preciso ainda ativar o toggle Habilitar Rocket.Chat em Configurações → Integrações → Rocket.Chat e salvar novamente. Lembre-se sempre da relação de duas etapas: Apps → Rocket.Chat define o servidor; Integrações → Rocket.Chat liga a visibilidade para a equipe. As duas telas são necessárias para o recurso funcionar de ponta a ponta.
Quem usa: Administrador.O que é: página para configurar credenciais TikTok próprias do tenant, substituindo o app global do Super Administrador. Se nenhuma configuração for criada aqui, o sistema usa automaticamente o app global.Passo a passo:
  1. Acesse Configurações → Apps → TikTok e clique em + Novo App TikTok.
  2. Preencha o bloco Login Kit (obrigatório): Client Key e Client Secret gerados no TikTok Developer Portal; cadastre exatamente o Redirect URI (OAuth callback) fixo do sistema no TikTok Developer Portal; o Webhook URL também é fixo.
  3. Se sua empresa também vai responder comentários de conteúdo veiculado como anúncio, preencha o bloco opcional TikTok API for Business: Business App ID (começa com “7…”) e Business App Secret.
  4. Informe uma Descrição opcional e ative Ativo.
Benefícios e quando usar: o Login Kit já habilita login e listagem de vídeos. Configure também a API for Business se sua empresa faz anúncios (Ads/Spark Ads) no TikTok e quer ler/responder comentários desse conteúdo pelo PanÐá Zap.
Limitação importante da própria API do TikTok: só é possível ler e responder comentários de conteúdo veiculado como anúncio (Ads/Spark Ads), via TikTok API for Business. Posts orgânicos não anunciados não têm comentários acessíveis pela API: isso não é uma limitação do PanÐá Zap, e sim uma regra do próprio TikTok.
O access_token expira em 24h; o sistema renova automaticamente via refresh_token, sem ação manual.
Quem usa: Administrador (configuração); Atendentes usam o seletor de produtos da loja durante o atendimento.O que é: página que permite ao tenant configurar as próprias credenciais de uma loja WooCommerce, substituindo a configuração global do Super Administrador, permitindo receber pedidos como tickets e usar o catálogo da loja durante o atendimento.Passo a passo:
  1. Acesse Configurações → Apps → WooCommerce e clique em + Novo App.
  2. Informe a URL da loja (ex.: https://minha-loja.com).
  3. Em WooCommerce → Configurações → Avançado → REST API, gere uma Consumer Key e uma Consumer Secret com permissão de Leitura/Escrita, e cole-as nos respectivos campos.
  4. Copie a URL do Webhook fixa e cole-a em WooCommerce → Configurações → Avançado → Webhooks → URL de entrega. O campo Callback do OAuth proxy é apenas informativo, não precisa ser cadastrado manualmente em lugar nenhum.
  5. Preencha o Webhook Secret (chave para validar as requisições recebidas do WooCommerce).
  6. Em Canal vinculado, associe o canal do PanÐá Zap que deve usar automaticamente esta loja no seletor de produtos durante o atendimento.
  7. Se quiser que o ticket se feche sozinho quando o pedido for concluído, ative Fechar ticket ao completar pedido.
  8. Preencha uma Descrição opcional, ative Ativo e salve.
Benefícios e quando usar: conecte sua loja WooCommerce quando quiser que pedidos virem tickets automaticamente e que os Atendentes consigam consultar/enviar produtos do catálogo sem sair da conversa.
Só é permitida uma integração por URL de loja: se a mesma URL já estiver cadastrada em outra integração, ocorre conflito. Exclua a integração antiga antes de recriar.
Configuração aqui sobrescreve a Global; sem configuração nesta página, usa-se a Global do Super Admin.
Quem usa: Administrador (configuração); Atendentes usam o seletor de produtos/pedidos da loja durante o atendimento.O que é: integração com a Nuvemshop para receber pedidos e notificar clientes automaticamente, com o catálogo da loja disponível durante o atendimento.Passo a passo:
  1. Acesse Apps → Nuvemshop e clique em Novo App.
  2. Escolha um dos dois modos de conexão:
    • Modo OAuth (recomendado): informe a URL da loja (ex.: https://minha-loja.com), clique em Conectar, faça login na sua loja Nuvemshop e autorize o acesso; as credenciais são preenchidas automaticamente ao retornar.
    • Modo manual (BYO): preencha diretamente Store ID (user_id retornado no OAuth ou encontrado no painel de parceiros), Access Token (não expira) e, opcionalmente, Client ID e Client Secret (usado para validar o HMAC dos webhooks no modo manual).
  3. Copie a URL do Webhook exibida e cole em Nuvemshop → Configurações → Avançado → Webhooks → URL de entrega. O campo Callback do OAuth proxy é fixo e apenas informativo.
  4. Configure as opções do app: Sincronizar produtos (mantém o cache do seletor de produtos atualizado), Canal vinculado (loja usada automaticamente quando o ticket vier desse canal), Descrição, Fechar ticket ao completar pedido e Ativo.
Benefícios e quando usar: assim como o WooCommerce, use quando quiser que pedidos da Nuvemshop virem tickets automaticamente e que o time consiga oferecer produtos do catálogo durante a conversa. É possível conectar mais de uma loja: quando há várias, um seletor de loja aparece nas telas de pedidos e produtos.
A conexão é verificada periodicamente. Se a loja desinstalar o app ou a autorização expirar, a integração exibe um aviso de reconexão: basta clicar em Conectar novamente para restaurar.
Quem usa: Administrador.O que é: página que permite ao tenant configurar suas próprias credenciais OAuth do Google, substituindo o app padrão definido pelo Super Administrador. Uma característica importante: um único app cobre Gmail, Google Calendar e YouTube ao mesmo tempo.Passo a passo:
  1. Acesse Configurações → Apps → Google e clique em + Novo App Google.
  2. Preencha o Client ID (OAuth 2.0) e o Client Secret, gerados no Google Cloud Console.
  3. Cadastre exatamente o Redirect URI (OAuth callback) fixo do sistema no Google Cloud Console, como “Authorized redirect URI”.
  4. Ative os produtos que deseja cobrir com este app: Gmail (canal de e-mail com OAuth), Google Calendar (sincronia de eventos e agendamentos) e/ou YouTube (comentários e live chat dos canais).
  5. Se ativou YouTube, ajuste o Intervalo de poll YouTube (seg): frequência de busca por novos comentários (padrão 30s, mínimo 15s).
  6. Preencha uma Descrição opcional e ative Ativo.
Benefícios e quando usar: simplifica a administração para empresas que usam vários produtos Google ao mesmo tempo (e-mail corporativo via Gmail, agenda e canal de YouTube), evitando cadastrar um app OAuth separado para cada um.
Se nenhuma configuração for criada aqui, o sistema usa automaticamente as credenciais configuradas pelo Super Admin (ou as do proxy da plataforma, como último recurso).
Scopes (avançado): deixe em branco para usar os valores padrão. Alterar os scopes manualmente pode quebrar a integração.
Esta tela é diferente (embora relacionada) da tela Habilitar Google Calendar, vista na seção Integrações: lá você conecta e gerencia contas/calendários individuais com suas próprias credenciais OAuth por configuração; aqui você define um único app Google que serve de base OAuth para Gmail, Calendar e YouTube no tenant inteiro.
Quem usa: Administrador (conexão via Sessões); Supervisores e Atendentes acompanham comentários e estatísticas dos canais conectados.O que é: página para visualizar os canais do YouTube conectados ao PanÐá Zap via OAuth Google. Cada canal aparece como um cartão com banner, foto e estatísticas atualizadas diretamente da API do YouTube.Passo a passo:
  1. Acesse Configurações → Apps → YouTube. Não há formulário de app nesta tela: a conexão é feita via Sessões.
  2. Acesse Configurações → Sessões (ou clique em Ir para Sessões na própria tela do YouTube).
  3. Crie um canal do tipo YouTube e autorize o acesso via OAuth Google.
  4. Após autorizar, o canal aparece automaticamente na lista de Apps → YouTube, com banner, foto, nome, número de inscritos, quantidade de vídeos e total de visualizações, além do status da conexão (ativa ou expirada).
  5. Use Sincronizar para atualizar os metadados do canal direto da API, Link externo para abrir o canal no YouTube em nova aba, ou Atualizar para recarregar todos os canais conectados.
Diferente dos demais apps desta página, o YouTube não tem formulário próprio de credenciais: ele reaproveita o app Google (Global ou do tenant) e a conexão do canal é feita pela tela de Sessões.
Ações disponíveis nos cartões de canal:Benefícios e quando usar: conecte quando quiser gerenciar comentários e live chat dos vídeos do canal da empresa dentro do mesmo painel de atendimento usado para os demais canais.
A sincronização sempre busca dados frescos direto da API: as estatísticas não ficam armazenadas permanentemente no banco de dados do PanÐá Zap.
Esta conexão depende do app Google configurado (seja o Global do Super Admin, seja o próprio do tenant em Apps → Google, com o produto YouTube habilitado).