> ## Documentation Index
> Fetch the complete documentation index at: https://ajuda.pandazap.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Cadastre Apps de Marketplace e Redes Sociais
> Como cadastrar credenciais próprias de LinkedIn, Mercado Livre, OLX, Rocket.Chat, TikTok, WooCommerce, Nuvemshop, Google e YouTube em Configurações > Apps, pré-requisito para conectar esses canais no PanÐá Zap.
## 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**.
| Campo | Valor / origem |
| ----------------------------- | ---------------------------------------------------------- |
| App ID (client\_id) | Gerado no LinkedIn Developer Portal |
| App Secret (client\_secret) | Gerado no LinkedIn Developer Portal |
| Redirect URI (OAuth callback) | Fixo: `https://oauth.techprovider.com.br/callback.html` |
| Webhook URL | Fixo: `https://oauth.techprovider.com.br/linkedin-webhook` |
| Descrição | Opcional |
| Ativo | Toggle |
**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**.
| Campo | Valor / origem |
| ----------------------------- | ---------------------------------------------------------------- |
| App ID (client\_id) | Gerado no portal de desenvolvedores do Mercado Livre (DevCenter) |
| Site ID | País de operação (Brasil = MLB, Argentina = MLA, México = MLM) |
| App Secret (client\_secret) | Gerado no DevCenter |
| Redirect URI (OAuth callback) | Fixo: `https://oauth.techprovider.com.br/callback.html` |
| Webhook URL | Fixo (não editável) |
| Descrição | Opcional |
| Ativo | Toggle |
**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**.
| Campo | Valor / origem |
| ----------------------------- | ----------------------------------------------------------------------------------- |
| Client ID | Fornecido pela OLX por e-mail, mediante solicitação a `suporteintegrador@olxbr.com` |
| Client Secret | Fornecido pela OLX por e-mail, mediante solicitação |
| Redirect URI (OAuth callback) | Fixo: `https://oauth.techprovider.com.br/callback.html` (informar exatamente à OLX) |
| Webhook URL | Fixo: `https://oauth.techprovider.com.br/olx-webhook` |
| Descrição | Opcional |
| Ativo | Toggle |
**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**.
| Campo | Valor / origem |
| ------------------------------- | -------------------------------------------------------------------------------- |
| URL do servidor | Ex.: `https://chat.suaempresa.com` |
| Admin User ID (X-User-Id) | Gerado no Rocket.Chat, em Perfil → Tokens de Acesso Pessoal |
| Admin Auth Token (X-Auth-Token) | Gerado no Rocket.Chat, em Perfil → Tokens de Acesso Pessoal |
| Descrição | Opcional |
| Criar usuários automaticamente | Toggle: cria conta automática no Rocket.Chat para cada agente no primeiro acesso |
| Ativo | Toggle |
**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**.
| Campo | Bloco | Valor / origem |
| ----------------------------- | ---------------------------------- | ----------------------------------------------------- |
| Client Key | Login Kit (obrigatório) | Gerado no TikTok Developer Portal |
| Client Secret | Login Kit (obrigatório) | Gerado no TikTok Developer Portal |
| Redirect URI (OAuth callback) | Login Kit (obrigatório) | Fixo, cadastrar exatamente no TikTok Developer Portal |
| Webhook URL | Login Kit (obrigatório) | Fixo |
| Business App ID | TikTok API for Business (opcional) | Começa com "7...", TikTok Developer Portal |
| Business App Secret | TikTok API for Business (opcional) | TikTok Developer Portal |
| Descrição | - | Opcional |
| Ativo | - | Toggle |
**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.
| Campo | Valor / origem |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| URL da loja | Ex.: `https://minha-loja.com` |
| Consumer Key | Gerada em WooCommerce → Configurações → Avançado → REST API (permissão Leitura/Escrita) |
| Consumer Secret | Gerada no mesmo local, permissão Leitura/Escrita |
| URL do Webhook | Fixa: `https://oauth.techprovider.com.br/woocommerce-webhook`, colar em WooCommerce → Configurações → Avançado → Webhooks → URL de entrega |
| Callback do OAuth proxy | Apenas informativo, não precisa ser cadastrado em lugar nenhum |
| Webhook Secret | Chave para validar requisições recebidas do WooCommerce |
| Canal vinculado | Canal do PanÐá Zap que usa esta loja automaticamente no seletor de produtos |
| Fechar ticket ao completar pedido | Toggle opcional |
| Descrição | Opcional |
| Ativo | Toggle |
**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**.
| Campo | Modo | Origem |
| --------------------------------- | ---------------------- | ----------------------------------------------------------------------------------------- |
| URL da loja | OAuth (recomendado) | Ex.: `https://minha-loja.com` |
| Store ID | Manual (BYO) | user\_id retornado no OAuth ou encontrado no painel de parceiros |
| Access Token | Manual (BYO) | Não expira |
| Client ID | Manual (BYO, opcional) | Usado para validar o HMAC dos webhooks |
| Client Secret | Manual (BYO, opcional) | Usado para validar o HMAC dos webhooks |
| URL do Webhook | Ambos | Exibida no app, colar em Nuvemshop → Configurações → Avançado → Webhooks → URL de entrega |
| Callback do OAuth proxy | Ambos | Fixo, apenas informativo |
| Sincronizar produtos | Ambos | Mantém o cache do seletor de produtos atualizado |
| Canal vinculado | Ambos | Loja usada automaticamente quando o ticket vier desse canal |
| Fechar ticket ao completar pedido | Ambos | Toggle opcional |
| Descrição | Ambos | Opcional |
| Ativo | Ambos | Toggle |
**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**.
| Campo | Valor / origem |
| ------------------------------- | ---------------------------------------------------------------------- |
| Client ID (OAuth 2.0) | Gerado no Google Cloud Console |
| Client Secret | Gerado no Google Cloud Console |
| Redirect URI (OAuth callback) | Fixo, cadastrar no Google Cloud Console como "Authorized redirect URI" |
| Produtos ativados | Gmail, Google Calendar e/ou YouTube (marcar os desejados) |
| Intervalo de poll YouTube (seg) | Só se YouTube ativado; padrão 30s, mínimo 15s |
| Descrição | Opcional |
| Ativo | Toggle |
**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:**
| Ação | O que faz |
| ------------ | ------------------------------------------------------- |
| Sincronizar | Atualiza os metadados do canal direto da API do YouTube |
| Link externo | Abre o canal no YouTube em nova aba |
| Atualizar | Recarrega todos os canais conectados |
**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).