O que é a tela Apps
Quem usa: Administrador. A aba Apps é onde sua empresa cadastra credenciais próprias para redes sociais e marketplaces. Se nada for cadastrado aqui, o sistema usa a configuração geral da plataforma para aquela integração, quando houver uma disponível. 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.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
LinkedIn
Quem usa: Administrador.O que é: página onde sua empresa cadastra credenciais OAuth próprias do LinkedIn, no lugar da configuração geral da plataforma. É usada para responder comentários e gerenciar a presença da empresa no LinkedIn pelo PanÐá Zap.Passo a passo:Ao cadastrar credenciais aqui, sua empresa passa a usar o próprio app em vez da configuração geral da plataforma; sem configuração nesta página, vale a configuração geral. O token do LinkedIn expira a cada 60 dias e é renovado automaticamente pelo PanÐá Zap: nenhuma ação manual é necessária.
- Acesse Configurações → Apps → LinkedIn.
- 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.
- Clique em + Novo App LinkedIn.
- Preencha o App ID (client_id) e o App Secret (client_secret) obtidos no LinkedIn Developer Portal.
- Copie o Redirect URI (OAuth callback), campo fixo que nesta plataforma é
https://oauth.pandazap.com/callback.html, e cadastre-o exatamente assim no LinkedIn Developer Portal. O Webhook URL também é fixo e não pode ser alterado: quando o portal pedir um endereço de webhook, use o botão de copiar ao lado do campo para levar o endereço exato exibido na tela. - 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.
Mercado Livre
Mercado Livre
Quem usa: Administrador.O que é: página onde sua empresa cadastra credenciais OAuth próprias do Mercado Livre, no lugar da configuração geral da plataforma. É usada para atender consultas e vendas feitas pelo Mercado Livre diretamente no PanÐá Zap.Passo a passo:
- Acesse Configurações → Apps → Mercado Livre. A listagem mostra os apps já configurados (colunas ID, App ID, Site, Descrição, Status).
- Clique em + Novo App ML.
- Preencha o App ID (client_id) gerado no portal de desenvolvedores do Mercado Livre.
- Selecione o Site ID: o país de operação (Brasil = MLB, Argentina = MLA, México = MLM, Colômbia = MCO, Chile = MLC, Uruguai = MLU, Peru = MPE ou Equador = MEC).
- Preencha o App Secret (client_secret).
- Copie o Redirect URI (OAuth callback), campo fixo que nesta plataforma é
https://oauth.pandazap.com/callback.html, e cadastre-o exatamente assim no DevCenter do Mercado Livre. O Webhook URL também é fixo e não pode ser alterado: copie o endereço exibido nesse campo (botão de copiar ao lado) e cadastre-o como URL de notificações do seu app no DevCenter. - 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 token de acesso do Mercado Livre expira a cada 6 horas e é renovado automaticamente. Mensagens pós-venda têm limite de 350 caracteres. A configuração feita aqui substitui a configuração geral da plataforma; sem configuração nesta página, vale a configuração geral.
OLX
OLX
Quem usa: Administrador.O que é: página onde sua empresa cadastra credenciais OAuth próprias da OLX, no lugar da configuração geral da plataforma.Passo a passo:
- Acesse Configurações → Apps → OLX e clique em + Novo App OLX.
- Preencha o Client ID e o Client Secret: ambos fornecidos pela OLX por e-mail, mediante solicitação.
- Ao solicitar as credenciais à OLX (contato:
suporteintegrador@olxbr.com), informe exatamente o Redirect URI (OAuth callback) fixo do sistema, que nesta plataforma éhttps://oauth.pandazap.com/callback.html. O Webhook URL também é fixo e não pode ser alterado: se a OLX pedir o endereço de webhook, copie o exibido nesse campo. - 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.Qualquer divergência no Redirect URI informado à OLX impede o funcionamento da integração. As respostas enviadas pela API da OLX são somente texto (sem imagens).
Rocket.Chat
Rocket.Chat
Quem usa: Administrador.O que é: página onde sua empresa cadastra o próprio servidor Rocket.Chat, no lugar da configuração geral da plataforma (quando houver uma). É 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. Se a lista mostrar uma linha com o selo Global, ela é a configuração geral da plataforma: aparece só para consulta, sem opções de editar, testar ou excluir.Antes de começar, no servidor Rocket.Chat:
- Use uma conta com papel admin no Rocket.Chat, de preferência dedicada à integração, e gere um Personal Access Token em Perfil → Tokens de Acesso Pessoal.
- Rocket.Chat 8 ou mais novo: defina no servidor a variável
CREATE_TOKENS_FOR_USERS_SECRET, reinicie o Rocket.Chat e guarde o valor: ele vai no campo Segredo de liberação de acesso. Sem isso, os atendentes não entram no chat já logados. Rocket.Chat 7: deixe o segredo vazio e definaCREATE_TOKENS_FOR_USERS=trueno servidor. - Em Administração → Configurações → Geral, desligue Restrict access inside any Iframe.
- Em Iframe Integration, ligue Enable Receive e Enable Send, com o endereço do seu painel do PanÐá Zap (ou
*) nas origens.
- Acesse Configurações → Apps → Rocket.Chat e clique em + Novo App RC.
- Informe a URL do servidor: o endereço completo com
https, igual ao que aparece no navegador quando o Rocket.Chat já está aberto (ex.:https://chat.suaempresa.com). Se o endereço redirecionar para outro, cadastre o de destino. - Cole o Admin User ID e o Admin Auth Token da conta de integração.
- Se o servidor for Rocket.Chat 8 ou mais novo, preencha o Segredo de liberação de acesso (o mesmo valor de
CREATE_TOKENS_FOR_USERS_SECRET). - Informe uma Descrição opcional e decida se quer Criar usuários automaticamente (veja as regras de conta abaixo).
- Clique em Testar conexão. O teste confere, sem salvar, tudo o que o chat precisa e mostra o Resultado do teste item a item: Servidor Rocket.Chat (com a versão), Conta de integração (conectado como…), Permissões da conta de integração (lista as que faltam), Liberação de acesso dos atendentes, Abrir o Rocket.Chat dentro do painel, Login automático pelo painel e Avisos do Rocket.Chat para o painel. Itens que dependem de um anterior aparecem como “Não testado”. Se aparecer “Conectado, mas faltam ajustes”, corrija o que o resultado apontar e teste de novo.
- Ative Ativo e salve. O teste usa o que está preenchido na tela; as mudanças só valem para os atendentes depois de salvar.
- Vá em Configurações → Integrações → Rocket.Chat e ative o toggle Habilitar Rocket.Chat (a mudança é salva na hora, sem botão Salvar). Só então os agentes conseguem acessar o chat em Comunicação e Marketing → Redes Sociais → Rocket.Chat.
Regras de conta dos atendentes (segurança):
- Cada atendente entra com a conta do Rocket.Chat que tem o mesmo e-mail cadastrado no painel, e esse e-mail precisa estar confirmado no Rocket.Chat. Um atendente nunca recebe a conta de outra pessoa.
- Contas de administrador do Rocket.Chat nunca são usadas pelo painel: quem é admin no Rocket.Chat entra direto por lá.
- Com Criar usuários automaticamente ligado, se o nome de usuário já estiver em uso ou não for permitido no Rocket.Chat, a conta nova ganha um número no fim (ex.:
maria.15). - Se sua empresa usa a configuração geral da plataforma (em vez de um servidor próprio), as contas do Rocket.Chat levam o código da empresa no início do nome (ex.:
t12.maria), e uma empresa nunca entra na conta de outra. Uma conta antiga sem esse código deixa de ser usada: peça ao administrador do Rocket.Chat para renomeá-la colocando o código na frente.
TikTok
TikTok
Quem usa: Administrador.O que é: página para cadastrar credenciais TikTok próprias da sua empresa, no lugar do app geral da plataforma. Se nenhuma configuração for criada aqui, o sistema usa automaticamente a configuração geral da plataforma, quando houver uma disponível.Passo a passo:
- Acesse Configurações → Apps → TikTok e clique em + Novo App TikTok.
- 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.
- 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.
- 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.O
access_token expira em 24h; o sistema renova automaticamente via refresh_token, sem ação manual.WooCommerce
WooCommerce
Quem usa: Administrador (configuração); Atendentes usam o seletor de produtos da loja durante o atendimento.O que é: página onde sua empresa cadastra as credenciais das próprias lojas WooCommerce, para receber pedidos como tickets e usar o catálogo da loja durante o atendimento.Passo a passo:
- Acesse Configurações → Apps → WooCommerce e clique em + Novo App.
- Informe a URL da loja (ex.:
https://minha-loja.com). - 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.
- Copie a URL do Webhook fixa exibida na tela (botão de copiar ao lado) 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.
- Preencha o Webhook Secret (chave para validar as requisições recebidas do WooCommerce).
- Em Canal vinculado, associe o canal do PanÐá Zap que deve usar automaticamente esta loja no seletor de produtos durante o atendimento.
- Se quiser que o ticket se feche sozinho quando o pedido for concluído, ative Fechar ticket ao completar pedido.
- Mantenha ligado Atualizar o cadastro do contato com os dados do pedido (vem ligado por padrão) para que cada pedido atualize o endereço do contato e complete aniversário e CPF que ainda estiverem em branco; desligue se não quiser que o pedido mexa nesses dados do contato.
- Preencha uma Descrição opcional, ative Ativo e salve.
- Ao editar um app já salvo, use Testar conexão para conferir URL e credenciais com a loja e Registrar Webhooks para criar na loja os webhooks de pedidos.
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.Se a lista mostrar uma linha com o selo Global, ela é a configuração geral da plataforma: aparece só para consulta e não pode ser editada nem excluída pela sua empresa.
Nuvemshop
Nuvemshop
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:
- Acesse Configurações → Apps → Nuvemshop e clique em Novo App.
- Escolha um dos dois modos de conexão:
- Modo OAuth (recomendado): informe a URL da loja (ex.:
https://minha-loja.com), ajuste as opções do app e salve. Depois, no menu da linha da loja, clique em Conectar via OAuth, faça login na sua loja Nuvemshop e autorize o acesso: as credenciais chegam automaticamente, o sistema registra os webhooks e cria um canal do tipo Nuvemshop para a loja (se já existir, ele é mantido). - Modo manual (BYO): preencha diretamente Store ID (user_id retornado no OAuth ou encontrado no painel de parceiros) e Access Token (não expira), sempre os dois juntos, e, opcionalmente, Client ID (app de parceiro) e Client Secret (app de parceiro) (usado para validar o HMAC dos webhooks no modo manual).
- Modo OAuth (recomendado): informe a URL da loja (ex.:
- 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.
- 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.
- Ao editar um app já salvo, use Testar conexão para conferir a conexão com a loja e Registrar Webhooks para criar os webhooks na loja.
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.
Google (beta)
Google (beta)
Quem usa: Administrador.O que é: página onde sua empresa cadastra as credenciais OAuth próprias do Google. Uma característica importante: um único app pode cobrir Gmail, Google Calendar e YouTube ao mesmo tempo.Passo a passo: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 em toda a sua empresa.
- Acesse Configurações → Apps → Google e clique em + Novo App Google.
- Preencha o Client ID (OAuth 2.0) e o Client Secret (ambos obrigatórios), gerados no Google Cloud Console.
- No Google Cloud Console, em “Authorized redirect URIs”, cadastre o endereço exibido no campo fixo Redirect URI (OAuth callback) (use o botão de copiar ao lado) e também
https://oauth.pandazap.com/callback.html. Os dois precisam estar completos, terminando em/callback.html. - Em Servicos habilitados, ative os produtos que deseja cobrir com este app (pelo menos um): Gmail (canal de e-mail com OAuth), Google Calendar (sincronia de eventos e agendamentos) e/ou YouTube (comentários e live chat dos canais).
- Se ativou YouTube, ajuste o Intervalo de poll YouTube (segundos): frequência de busca por novos comentários (padrão 30s, mínimo 15s).
- 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.
Não há app Google padrão disponível: sem uma configuração aqui, cada recurso usa as credenciais próprias informadas na própria tela (o Google Calendar e o canal Gmail pedem Client ID e Client Secret).
YouTube
YouTube
Quem usa: Administrador (conexão do canal em Administração → Canais); Supervisores com permissão acompanham os comentários em Comunicação e Marketing → Redes Sociais → YouTube.O que é: página Canais YouTube, que mostra os canais do YouTube conectados ao PanÐá Zap via OAuth Google. Cada canal aparece como um cartão com banner, foto e estatísticas buscadas diretamente da API do YouTube.Passo a passo:Ações disponíveis nos cartões de canal:
- Acesse Configurações → Apps → YouTube. Não há formulário de app nesta tela: a conexão do canal é feita em Administração → Canais.
- Clique em Ir para Sessões (quando ainda não há canal conectado) ou em Gerenciar em Sessões no cartão de um canal: os dois abrem a tela de canais.
- Crie um canal do tipo YouTube e autorize o acesso via OAuth Google.
- Após autorizar, o canal aparece automaticamente em Apps → YouTube, com banner, foto, nome, número de inscritos, quantidade de vídeos e total de visualizações, além do status (Conectado ou Desconectado). No topo, os cartões Total de canais, Conectado e Desconectado resumem a situação.
- Use Sincronizar para atualizar os metadados do canal direto da API, Abrir no YouTube para abrir o canal em nova aba, ou Atualizar (no topo) 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 (o padrão da plataforma ou o cadastrado pela sua empresa) e a conexão do canal é feita pela tela de canais.
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.Esta conexão depende de um app Google disponível: o padrão da plataforma ou o da sua empresa em Apps → Google, com o produto YouTube habilitado.

