> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-superadmin/redes-sociais-e-marketplaces/woocommerce-superadmin.md). # WooCommerce - Superadmin Esta documentação detalha o processo completo para integrar uma loja **WooCommerce** (plugin de e-commerce do WordPress) à plataforma **Z-PRO**, permitindo que você gerencie pedidos, produtos e seja notificado em tempo real sobre as compras realizadas em sua loja. O **WooCommerce** é o plugin de e-commerce mais popular do WordPress. Com essa integração, o Z-PRO se conecta à sua loja para sincronizar produtos, receber pedidos como tickets e permitir a gestão comercial diretamente do painel. {% hint style="warning" %} **Configuração global vs. por tenant:** os apps cadastrados aqui ficam disponíveis para todos os tenants. A conexão e o gerenciamento do número WABA de cada tenant é feito individualmente pelo Administrador em Configurações → Integrações {% endhint %} {% hint style="info" %} **Pré-requisitos:** * Uma loja WordPress com o plugin **WooCommerce** instalado e ativo. * Acesso de **Super Admin** na sua instalação do Z-PRO. * Acesso de **Administrador** no painel do WordPress. {% endhint %} {% hint style="info" %} **Páginas de referência das telas do admin:**\ [Apps — WooCommerce ](/configuracao-administrador/configuracoes-painel-admin/apps-configuracoes/woocommerce-configuracao-apps.md) [Canal WooCommerce](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-woocommerce.md) {% endhint %} {% embed url="" %} *** ### Etapa 1: Acessando o App WooCommerce no Painel Super Admin A integração com o WooCommerce é configurada inicialmente pelo painel **Super Admin** do Z-PRO. 1. Faça login no Z-PRO com o usuário **Super Administrador** da sua instalação. 2. No menu lateral, localize a seção **Redes Sociais / Marketplace**. 3. Clique na opção **App WooCommerce**. 4. Clique no botão **Novo App** para criar uma nova integração. {% hint style="info" %} Caso já existam integrações criadas, elas serão listadas nesta tela. Para criar uma nova, basta clicar em **Novo App**. {% endhint %} *** ### Etapa 2: Definindo o Escopo da Integração (Global ou Tenant) Ao criar um novo app, o Z-PRO solicitará que você defina o escopo da integração: * **Global:** A integração será aplicada para toda a instalação (todos os tenants). * **Tenant (Empresa):** A integração será aplicada apenas para uma conta/empresa específica. {% hint style="warning" %} **Recomendação:** Na maioria dos casos, escolha o escopo **Tenant**. Cada cliente normalmente possui seu próprio e-commerce, portanto, o uso global é raro e indicado apenas para cenários muito específicos. {% endhint %} Selecione a empresa (tenant) para a qual o e-commerce será integrado. Para quem revende o Z-PRO, esta será a conta do cliente final. *** ### Etapa 3: Obtendo a URL da Loja e o Callback Após selecionar o escopo, preencha os seguintes campos no formulário: 1. **URL da Loja:** Copie e cole o endereço completo da sua loja WooCommerce (ex.: `https://minhaloja.com.br`). 2. **Callback:** Este campo já vem **preenchido automaticamente** pelo Z-PRO. Não é necessário alterar. {% hint style="danger" %} **Importante:** Só é permitida **uma integração por loja**. Se você já possuir uma URL integrada, não será possível cadastrar a mesma novamente sem antes excluir a integração existente, sob pena de conflito. {% endhint %} *** ### Etapa 4: Gerando as Chaves de API no WooCommerce Para conectar o Z-PRO à sua loja, é necessário gerar as chaves de API (**Consumer Key** e **Consumer Secret**) no painel do WordPress. 1. Acesse o **Dashboard** do seu WordPress como administrador. 2. No menu lateral, vá em **WooCommerce > Configurações**. 3. Clique na aba **Avançado**. 4. Dentro de "Avançado", clique em **REST API**. 5. Clique em **Adicionar uma nova chave**. 6. Preencha os campos: * **Descrição:** Informe uma identificação para a chave (ex.: `Zepro Integração WooCommerce`). * **Usuário:** Selecione o usuário administrador. * **Permissões:** Selecione **Leitura/Escrita**. {% hint style="danger" %} **Atenção às permissões!** A integração com o Z-PRO precisa de permissão de **Leitura e Escrita** para funcionar corretamente. Isso porque, além de receber dados, o Z-PRO também precisa **gerir produtos e pedidos** diretamente na loja. Se você selecionar apenas leitura, várias funcionalidades não funcionarão. {% endhint %} 7. Clique em **Gerar chave API**. 8. O WordPress exibirá o **Consumer Key** e o **Consumer Secret**. **Copie e guarde ambos imediatamente**, pois o Consumer Secret só é mostrado uma única vez.
woocommerce_api_consumer_key_secret
*** ### Etapa 5: Inserindo as Chaves no Z-PRO Volte para a tela de criação do app no Z-PRO e preencha: 1. **Consumer Key:** Cole o valor copiado do WooCommerce. 2. **Consumer Secret:** Cole o valor copiado do WooCommerce. 3. **Webhook Secret:** Deixe este campo **em branco**. Ele será preenchido automaticamente ao conectar via OAuth na próxima etapa. 4. **Canal Vinculado:** Campo **opcional**. Pode ser deixado em branco neste momento — o canal pode ser criado posteriormente.
wocommerce_integration_zpro
Clique em **Criar** para salvar a integração. *** ### Etapa 6: Conectando via OAuth e Registrando os Webhooks Após criar a integração, é necessário conectá-la via OAuth para que o Z-PRO registre automaticamente todos os webhooks necessários para receber os eventos da loja. 1. Localize a integração recém-criada na lista. 2. Clique nos **três pontinhos** (menu de ações) ao lado da integração. 3. Selecione a opção **Conectar via OAuth**. 4. Uma nova tela será aberta para configurar os webhooks dos eventos.
oauth_woocommerce_zpro
{% hint style="info" %} **Login no WordPress:** Caso você não esteja logado no WordPress no navegador, será solicitado que você faça login com seu usuário administrador antes de aprovar a conexão. {% endhint %} 5. Clique em **Aprovar** para que o Z-PRO crie automaticamente todos os webhooks necessários. 6. O sistema exibirá a mensagem **"Registrando webhooks"** e, em seguida, **"Webhooks registrados"**, confirmando o sucesso da conexão. #### Verificando os webhooks criados Caso queira conferir os webhooks que foram criados automaticamente pela integração OAuth, acesse: * **WordPress > WooCommerce > Configurações > Avançado > Webhooks** Você verá um webhook para cada evento do e-commerce (criação de pedidos, atualização de status, gestão de produtos etc.). {% hint style="info" %} **Por que usar OAuth?** O método OAuth elimina a necessidade de criar manualmente cada webhook na loja, automatizando todo o processo e garantindo que a integração esteja completa e funcional. {% endhint %} *** ### Etapa 7: Acessando a Gestão Comercial do WooCommerce no Z-PRO Com a integração ativa, acesse o painel administrativo do Z-PRO da conta (Tenant) integrada e vá em: * **Gestão Comercial > WooCommerce** Nesta tela você terá acesso a duas abas principais: **Pedidos** e **Produtos**. #### Aba "Pedidos" A aba de pedidos lista todas as compras realizadas na sua loja após a integração ser ativada. {% hint style="warning" %} **A integração não importa o histórico de pedidos anteriores.** A aba de pedidos começará vazia e será preenchida à medida que novos pedidos forem realizados na loja após a configuração da integração. {% endhint %} Cada pedido exibirá: * Nome do **cliente** * **Data** do pedido * **Status** do pedido * **Quantidade de itens** * **Valor total** * **Forma de pagamento**
Você poderá: * Ver mais detalhes do pedido * **Alterar o status** (Em espera, Concluído, Cancelado, Reembolsado etc.) * **Enviar mensagem ao comprador** escolhendo o canal de envio (Z-PRO, WhatsApp oficial, WhatsApp não oficial, E-mail etc.) #### Aba "Produtos" A aba de produtos lista **todos** os produtos cadastrados na sua loja WooCommerce (não apenas os novos — todo o catálogo é exibido). Você poderá: * **Criar novos produtos** diretamente pelo Z-PRO * **Editar** produtos existentes (preço, estoque, descrição, imagem etc.) * **Gerenciar estoque** sem precisar acessar o painel do WordPress
**Criando um novo produto pelo Z-PRO** 1. Clique em **Novo Produto**. 2. Preencha os campos: * **Nome do produto** * **Tipo** (Simples, Variável etc.) * **Status** (Publicado, Rascunho) * **Preço** e **Preço promocional** * **SKU** * **Quantidade em estoque** * **Imagem do produto** 3. Clique em **Salvar**. O produto será criado simultaneamente na loja WooCommerce. {% hint style="info" %} **Atenção ao formato das imagens.** Caso a imagem enviada esteja em um formato não suportado, ela poderá não aparecer no produto. Utilize formatos padrão (JPG, PNG) com dimensões adequadas. {% endhint %} *** ### Etapa 8: Criando um Canal WooCommerce para Receber Notificações Por padrão, a aba **Gestão Comercial > WooCommerce** não emite notificações em tempo real sobre os pedidos. Para ser **notificado a cada novo pedido**, você precisa criar um **Canal WooCommerce**. #### Como criar o canal 1. Acesse o menu **Canais** no painel administrativo do Z-PRO. 2. Clique em **Adicionar Canal**. 3. Selecione o tipo **WooCommerce**. 4. Informe a **URL da loja** (a mesma utilizada na integração). 5. Clique em **Criar Canal**.
canal_wocommerce_zpro
A integração será automaticamente vinculada, e todos os novos pedidos passarão a chegar como **tickets** no Z-PRO. {% hint style="warning" %} **O canal WooCommerce é apenas de entrada.** Não é possível responder mensagens ou conversar com o cliente diretamente por este canal. Ele serve **exclusivamente para receber notificações de pedidos**. Para conversar com o cliente, abra um ticket em outro canal de comunicação (WhatsApp, E-mail etc.) usando os dados de contato do pedido. {% endhint %} *** ### Etapa 9: Funcionamento dos Tickets de Pedidos Após a criação do canal, cada novo pedido realizado na loja gerará automaticamente um **ticket** no Z-PRO, contendo: * **Número do pedido** * **Valor** * **Produto(s) comprado(s)** * **Dados do comprador** (nome, e-mail, endereço) * **Status do pedido** * **Canais disponíveis para resposta** (e-mail, telefone — se o cliente informou no checkout) {% hint style="info" %} **Quer receber o telefone do cliente?** Por padrão, o WooCommerce não exige telefone no checkout. Para que o telefone apareça nos canais de resposta do ticket, configure o campo como **obrigatório** no checkout do WordPress. {% endhint %} #### Fluxo recomendado de atendimento 1. O cliente realiza uma compra na loja. 2. Um ticket é gerado automaticamente no Z-PRO via canal WooCommerce. 3. O atendente visualiza o pedido e os dados do cliente. 4. Caso seja necessário entrar em contato com o cliente, abre-se um novo ticket em um canal de conversa (WhatsApp, E-mail etc.). 5. Após resolver o pedido, o ticket pode ser **encerrado**. *** ### Resumo das Funcionalidades | Funcionalidade | Onde acessar | | ------------------------------------- | ----------------------------------------- | | Listar e gerenciar pedidos | Gestão Comercial > WooCommerce > Pedidos | | Listar, criar e editar produtos | Gestão Comercial > WooCommerce > Produtos | | Alterar status do pedido | Aba Pedidos (botão de ação no pedido) | | Enviar mensagem ao comprador | Aba Pedidos (botão de mensagem) | | Receber notificações de novos pedidos | Canal WooCommerce (criado em Canais) | | Configurar integração | Super Admin > App WooCommerce | *** ### Encerramento Com a integração concluída, o Z-PRO passa a: * **Receber** automaticamente todos os pedidos realizados na sua loja WooCommerce. * **Notificar** sua equipe via tickets sempre que um novo pedido for criado. * **Permitir a gestão** completa de pedidos e produtos diretamente pelo painel do Z-PRO, sem necessidade de acessar o WordPress. * **Centralizar** o atendimento ao cliente, vinculando os pedidos aos seus canais de comunicação (WhatsApp, E-mail etc.). Essa integração é ideal para empresas que desejam **unificar a operação de e-commerce e atendimento** em uma única plataforma, ganhando agilidade na resposta aos clientes e melhor controle dos pedidos. *** ### Possíveis Erros e Soluções #### Erro: "URL já cadastrada / integração duplicada" **Causa:** Já existe uma integração ativa com a mesma URL da loja. **Solução:** Exclua a integração antiga antes de criar uma nova. Lembre-se que só é permitida **uma integração por loja**. #### Webhooks não foram registrados **Causa:** Falha de login no WordPress durante o processo de OAuth ou permissões insuficientes da chave API. **Solução:** 1. Verifique se você está logado como **administrador** no WordPress. 2. Confirme que a chave API foi gerada com permissão de **Leitura/Escrita**. 3. Refaça o processo de **Conectar via OAuth**. #### Produtos criados pelo Z-PRO não aparecem com imagem **Causa:** Formato ou tamanho da imagem fora do padrão suportado pelo WooCommerce. **Solução:** Utilize imagens em formato **JPG ou PNG** com dimensões padronizadas (ex.: 800x800px). #### Cliente não aparece com telefone no ticket **Causa:** O campo telefone não está marcado como obrigatório no checkout do WooCommerce. **Solução:** Configure o campo telefone como **obrigatório** nas configurações do checkout do WordPress. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.zdg.com.br/configuracao-superadmin/redes-sociais-e-marketplaces/woocommerce-superadmin.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.