Chat Pró Oratrix: Como conectar o Canal WooCommerce

Chatbot Pró da Oratrix
1

:parrot: SERVIÇO

Serviço: Chat Pró Oratrix

:hammer_and_wrench: VOCÊ VAI PRECISAR

Antes de iniciar, tenha em mãos:

  • Acesso de administrador ao Chat Pró Oratrix.
  • Uma loja WordPress com o WooCommerce instalado e ativo.
  • Acesso de administrador ao painel do WordPress.
  • Permissão para criar chaves da API REST do WooCommerce.
  • O endereço completo da loja.
  • Uma fila ou departamento criado no Chat Pró Oratrix.
  • Um computador conectado à internet.

:warning: A integração precisa ser configurada antes da criação do canal. O Canal WooCommerce é utilizado somente para receber notificações de novos pedidos.

:receipt: VISÃO GERAL

O Canal WooCommerce permite que cada novo pedido realizado na loja gere automaticamente um ticket no Chat Pró Oratrix.

O ticket pode apresentar o número do pedido, os produtos comprados, o valor, o status e os dados fornecidos pelo comprador.

Esse canal é apenas de entrada. Não é possível conversar diretamente com o cliente por ele. Quando for necessário entrar em contato, utilize os dados do pedido para abrir um atendimento por WhatsApp, e-mail ou outro canal disponível.

:compass: PASSO A PASSO GUIADO

Etapa 1: Confirme os requisitos da loja

  1. Acesse o painel do WordPress.
  2. Confirme que o plugin WooCommerce está instalado e ativo.
  3. Abra WooCommerce > Pedidos.
  4. Verifique se a loja está recebendo pedidos normalmente.
  5. Confirme que você possui acesso de administrador.
  6. Copie o endereço principal da loja.

Exemplo:

https://minhaloja.com.br

:white_check_mark: Continue somente depois de confirmar que a loja está funcionando normalmente.

Etapa 2: Gere as chaves da API no WooCommerce

  1. No painel do WordPress, clique em WooCommerce.
  2. Clique em Configurações.
  3. Abra a aba Avançado.
  4. Clique em REST API.
  5. Clique em Adicionar uma nova chave.
  6. No campo Descrição, informe um nome para identificar a integração.

Exemplo:

Integração Chat Pró Oratrix

  1. No campo Usuário, selecione um usuário administrador.
  2. No campo Permissões, selecione Leitura/Escrita.
  3. Clique em Gerar chave API.
  4. Copie a Consumer Key.
  5. Copie a Consumer Secret.
  6. Guarde as duas informações em local seguro.

:warning: A Consumer Secret pode ser apresentada somente nesse momento. Copie-a antes de fechar a página.

:warning: A permissão precisa ser Leitura/Escrita. Com permissão somente de leitura, parte das funcionalidades poderá não funcionar.

Etapa 3: Acesse a configuração de aplicativos

  1. Acesse o Chat Pró Oratrix.
  2. Informe seu usuário e sua senha.
  3. Abra o Painel Admin.
  4. No menu lateral, clique em Configurações.
  5. Clique em Apps.
  6. Localize a opção WooCommerce.
  7. Clique em Novo App.

Etapa 4: Informe a URL da loja

  1. Localize o campo URL da Loja.
  2. Cole o endereço principal da loja.

Exemplo:

https://minhaloja.com.br

  1. Confirme que o endereço começa com https://.
  2. Não inclua páginas internas como /produto, /carrinho ou /checkout.
  3. Não adicione espaços antes ou depois do endereço.

:warning: Somente uma integração pode ser cadastrada para cada URL de loja. Caso a mesma URL já esteja cadastrada, será necessário excluir a configuração anterior antes de criar outra.

Etapa 5: Confira o callback

  1. Localize o campo Callback do OAuth Proxy.
  2. Não altere o valor apresentado.
  3. Esse campo é informativo e já vem preenchido pelo sistema.

:warning: Não é necessário cadastrar manualmente o callback em outro local.

Etapa 6: Informe as chaves da API

  1. Localize o campo Consumer Key.
  2. Cole a chave gerada no WooCommerce.
  3. Localize o campo Consumer Secret.
  4. Cole a chave secreta.
  5. Confirme que as duas informações foram copiadas por completo.
  6. Verifique se não existem espaços no início ou no final.

:warning: Não compartilhe essas chaves em grupos, mensagens públicas ou capturas de tela.

Etapa 7: Configure o webhook

  1. Localize o campo URL do Webhook.
  2. Copie a URL apresentada pelo Chat Pró Oratrix.
  3. Não altere esse endereço.
  4. Volte ao painel do WordPress.
  5. Acesse WooCommerce > Configurações.
  6. Clique em Avançado.
  7. Clique em Webhooks.
  8. Clique em Adicionar webhook.
  9. Informe um nome para identificar o webhook.

Exemplo:

Pedidos - Chat Pró Oratrix

  1. No campo Status, selecione Ativo.
  2. No campo Tópico, escolha o evento desejado, quando a criação for manual.
  3. No campo URL de entrega, cole a URL copiada do Chat Pró Oratrix.
  4. No campo Segredo, informe o mesmo valor configurado como Webhook Secret.
  5. Salve.

:information_source: Quando a conexão por OAuth for utilizada, os webhooks necessários poderão ser registrados automaticamente.

Etapa 8: Informe o Webhook Secret

  1. Volte ao Chat Pró Oratrix.
  2. Localize o campo Webhook Secret.
  3. Informe uma chave secreta forte.

Exemplo de formato:

Loja2026_Pedidos_Seguro

  1. Não utilize uma senha pessoal.
  2. Guarde essa chave em local seguro.
  3. Utilize exatamente o mesmo valor na configuração do webhook do WooCommerce.

:warning: O segredo é utilizado para validar se a notificação realmente foi enviada pela loja.

Etapa 9: Configure o fechamento automático

  1. Localize a opção Fechar ticket ao completar pedido.
  2. Ative caso deseje que o ticket seja encerrado automaticamente quando o pedido for marcado como Concluído.
  3. Mantenha desativada caso a equipe precise revisar o ticket antes do encerramento.

:white_check_mark: Quando ativada, a mudança do pedido para o status concluído poderá encerrar automaticamente o ticket correspondente.

Etapa 10: Ative a integração

  1. Localize a opção Ativo.
  2. Mantenha a opção habilitada.
  3. Informe uma descrição para identificar a loja.

Exemplo:

Loja principal da empresa

  1. Revise todos os campos.
  2. Clique em Salvar ou Criar.

:white_check_mark: A configuração estará criada quando aparecer na lista de aplicativos WooCommerce.

Etapa 11: Conecte a integração por OAuth

  1. Localize a integração criada.
  2. Clique nos três pontinhos ou no menu de ações.
  3. Selecione Conectar via OAuth.
  4. Aguarde a abertura da página do WordPress.
  5. Caso seja solicitado, faça login como administrador.
  6. Leia as permissões apresentadas.
  7. Clique em Aprovar.
  8. Aguarde a mensagem Registrando webhooks.
  9. Aguarde a confirmação Webhooks registrados.

:white_check_mark: Essa mensagem confirma que os eventos necessários foram cadastrados.

Etapa 12: Confirme os webhooks no WooCommerce

  1. Acesse o painel do WordPress.
  2. Clique em WooCommerce.
  3. Clique em Configurações.
  4. Abra a aba Avançado.
  5. Clique em Webhooks.
  6. Confirme se os webhooks foram criados.
  7. Verifique se o status está ativo.

:warning: Caso nenhum webhook tenha sido criado, confirme se a conexão OAuth foi aprovada por um usuário administrador.

:loudspeaker: CRIAÇÃO DO CANAL

Etapa 13: Acesse a área de canais

  1. Volte ao Painel Admin do Chat Pró Oratrix.
  2. Clique em Administração.
  3. Clique em Canais.
  4. Clique em Adicionar Canal.
  5. Selecione WooCommerce.

Etapa 14: Informe o nome do canal

  1. No campo Nome do Canal, informe uma identificação clara.

Exemplos:

  • WooCommerce Loja Principal
  • Pedidos Loja Virtual
  • WooCommerce Comercial
  • Notificações de Pedidos
  1. Evite nomes genéricos como:
  • Canal 1
  • Teste
  • Novo canal
  1. Caso exista a opção Canal padrão, defina se esse canal será utilizado como padrão pelo sistema.

Etapa 15: Configure as atribuições

  1. Localize o campo Fila.
  2. Selecione o departamento que receberá os tickets dos pedidos.

Exemplos:

  • E-commerce
  • Comercial
  • Expedição
  • Atendimento
  • Pós-venda
  1. Localize o campo Usuário.
  2. Selecione um atendente específico, caso necessário.
  3. Deixe o campo vazio quando os tickets forem distribuídos pela fila.

:warning: Escolha uma fila acompanhada regularmente para que os novos pedidos não fiquem sem tratamento.

Etapa 16: Informe a URL da loja

  1. Localize o campo URL da Loja.
  2. Informe exatamente a mesma URL utilizada na configuração do aplicativo.

Exemplo:

https://minhaloja.com.br

  1. Não adicione barras ou páginas extras.
  2. Confirme que a URL corresponde à loja correta.

:white_check_mark: O sistema utilizará essa URL para localizar e vincular automaticamente a integração correspondente.

Etapa 17: Configure as opções adicionais

A tela poderá apresentar as seguintes opções:

Mensagem de despedida

Permite definir uma mensagem utilizada ao encerrar o ticket.

:warning: Como o Canal WooCommerce é somente de entrada, confirme como essa mensagem será utilizada antes de configurá-la.

Webhook do canal

Permite enviar eventos do canal para outro sistema.

:warning: Ative somente quando possuir uma URL fornecida por um responsável técnico.

Recursos do canal

Permite configurar comportamentos adicionais.

Ative somente os recursos necessários para sua operação.

Etapa 18: Crie o canal

  1. Revise o nome do canal.
  2. Confira a fila.
  3. Verifique o usuário responsável.
  4. Confirme a URL da loja.
  5. Clique em Criar Canal ou Salvar.
  6. Aguarde o canal aparecer na lista.

:white_check_mark: O canal estará pronto quando aparecer na lista de canais e estiver vinculado à integração da loja.

:test_tube: TESTE DE FUNCIONAMENTO

Etapa 19: Faça um pedido de teste

  1. Abra a loja em uma janela anônima.
  2. Adicione um produto ao carrinho.
  3. Acesse o checkout.
  4. Preencha os dados de teste.
  5. Utilize uma forma de pagamento autorizada para testes.
  6. Finalize o pedido.
  7. Anote o número do pedido.

:warning: Não realize uma cobrança real sem autorização. Utilize o método de teste disponível na loja.

Etapa 20: Confirme o recebimento do ticket

  1. Acesse o Chat Pró Oratrix.
  2. Abra a tela de atendimentos.
  3. Verifique os tickets pendentes.
  4. Localize o ticket do pedido.
  5. Confirme se o número do pedido está correto.
  6. Confira os produtos.
  7. Verifique o valor.
  8. Confira o nome e os dados do comprador.
  9. Verifique o status do pedido.

:white_check_mark: A integração está funcionando quando o novo pedido gera um ticket no painel.

Etapa 21: Confirme o pedido na Gestão Comercial

  1. No menu, clique em Gestão Comercial.
  2. Clique em WooCommerce.
  3. Abra a aba Pedidos.
  4. Localize o pedido de teste.
  5. Confira os dados.
  6. Abra os detalhes.

:warning: A integração não importa o histórico anterior. A lista será preenchida com os pedidos recebidos após a ativação.

Etapa 22: Teste a mudança de status

  1. Abra o pedido na área de Gestão Comercial.
  2. Altere o status, quando essa opção estiver disponível.
  3. Selecione um status adequado para o teste.
  4. Salve.
  5. Abra o WooCommerce.
  6. Confirme se o status também foi atualizado na loja.

:warning: Essa função depende das chaves da API possuírem permissão de Leitura/Escrita.

Etapa 23: Teste o encerramento automático

Caso a opção Fechar ticket ao completar pedido esteja ativa:

  1. Altere o pedido para Concluído.
  2. Aguarde a sincronização.
  3. Volte ao ticket correspondente.
  4. Confirme se ele foi encerrado automaticamente.

:white_check_mark: O fechamento automático estará funcionando quando o ticket for encerrado após o pedido ser concluído.

:shopping_bags: GESTÃO DE PRODUTOS

Etapa 24: Consulte os produtos

  1. Acesse Gestão Comercial > WooCommerce.
  2. Abra a aba Produtos.
  3. Aguarde o catálogo carregar.
  4. Confirme se os produtos aparecem.
  5. Abra um produto para visualizar os detalhes.

:information_source: Diferentemente dos pedidos, a lista de produtos pode apresentar todo o catálogo da loja.

Etapa 25: Crie um produto pelo Chat Pró Oratrix

  1. Clique em Novo Produto.
  2. Informe o nome.
  3. Escolha o tipo do produto.
  4. Defina o status como publicado ou rascunho.
  5. Informe o preço.
  6. Informe o preço promocional, quando necessário.
  7. Preencha o SKU.
  8. Informe a quantidade em estoque.
  9. Adicione uma imagem em formato JPG ou PNG.
  10. Revise os dados.
  11. Clique em Salvar.

:white_check_mark: O produto deverá ser criado também na loja WooCommerce.

:warning: OBSERVAÇÕES IMPORTANTES

  • O Canal WooCommerce é somente de entrada.
  • Não é possível conversar com o comprador diretamente por esse canal.
  • Para falar com o cliente, abra um atendimento por WhatsApp, e-mail ou outro canal.
  • Cada novo pedido pode gerar um ticket.
  • A integração não importa pedidos anteriores.
  • Somente pedidos realizados após a ativação serão recebidos.
  • A lista de produtos pode apresentar todo o catálogo.
  • As chaves precisam ter permissão de Leitura/Escrita.
  • O Consumer Secret deve permanecer protegido.
  • Somente uma integração pode utilizar a mesma URL de loja.
  • A URL informada no canal deve ser igual à URL cadastrada no aplicativo.
  • Os webhooks precisam estar ativos.
  • O usuário do WordPress utilizado no OAuth precisa ser administrador.
  • O telefone do comprador somente aparecerá se for informado no checkout.
  • Caso precise sempre do telefone, configure esse campo como obrigatório na loja.
  • Imagens de produtos devem utilizar formatos compatíveis, como JPG ou PNG.
  • O nome e a posição dos campos podem variar conforme a versão do Chat Pró Oratrix.

:gear: DICAS E BOAS PRÁTICAS

  • Utilize uma fila exclusiva para pedidos.
  • Defina responsáveis por acompanhar os novos tickets.
  • Mantenha as chaves em um gerenciador de senhas.
  • Não compartilhe a Consumer Secret.
  • Faça um pedido de teste depois da configuração.
  • Verifique os webhooks após a conexão OAuth.
  • Não cadastre a mesma loja duas vezes.
  • Utilize a URL principal da loja.
  • Configure o telefone como obrigatório no checkout, quando necessário.
  • Revise o fechamento automático antes de ativá-lo.
  • Utilize imagens JPG ou PNG nos produtos.
  • Teste alterações de status.
  • Verifique periodicamente se os webhooks continuam ativos.
  • Não exclua a integração enquanto o canal estiver em uso.

:hammer_and_wrench: SOLUÇÃO DE PROBLEMAS

A opção WooCommerce não aparece

  1. Confirme que está utilizando um perfil administrador.
  2. Acesse Administração > Canais.
  3. Clique em Adicionar Canal.
  4. Procure pela opção WooCommerce.
  5. Atualize a página.
  6. Saia e entre novamente no sistema.
  7. Caso a opção continue ausente, solicite à Oratrix a verificação da disponibilidade.

Aparece erro de URL já cadastrada

Uma possível causa é a existência de outra integração com a mesma loja.

  1. Acesse Configurações > Apps > WooCommerce.
  2. Procure pela URL da loja.
  3. Confirme se já existe uma configuração.
  4. Edite a configuração existente ou exclua a antiga.
  5. Não mantenha duas integrações para a mesma URL.
  6. Tente novamente.

Os webhooks não foram registrados

Uma possível causa é falta de permissão ou falha na conexão OAuth.

  1. Confirme que você está conectado ao WordPress como administrador.
  2. Verifique se as chaves possuem permissão de Leitura/Escrita.
  3. Abra a integração no Chat Pró Oratrix.
  4. Clique novamente em Conectar via OAuth.
  5. Aprove a conexão.
  6. Aguarde a mensagem Webhooks registrados.
  7. Confira em WooCommerce > Configurações > Avançado > Webhooks.

O novo pedido não gerou ticket

  1. Confirme se a integração está ativa.
  2. Verifique se o canal foi criado.
  3. Confirme se a URL do canal é igual à URL da integração.
  4. Confira se os webhooks estão ativos.
  5. Verifique a fila configurada.
  6. Procure o ticket em pendentes, abertos e resolvidos.
  7. Realize um novo pedido de teste.
  8. Confirme se o pedido foi criado após a ativação da integração.

Os pedidos antigos não aparecem

Esse é o comportamento esperado.

  1. A integração não importa o histórico anterior.
  2. Somente novos pedidos serão recebidos após a ativação.
  3. Consulte os pedidos antigos diretamente no WooCommerce.

O telefone não aparece no ticket

Uma possível causa é o campo de telefone não ter sido preenchido no checkout.

  1. Abra as configurações do checkout da loja.
  2. Localize o campo de telefone.
  3. Configure-o como obrigatório, quando necessário.
  4. Salve.
  5. Realize um novo pedido de teste.

Não consigo alterar produtos ou pedidos

Uma possível causa é a chave possuir somente permissão de leitura.

  1. Acesse WooCommerce > Configurações > Avançado > REST API.
  2. Localize a chave utilizada.
  3. Confirme as permissões.
  4. Caso necessário, gere uma nova chave.
  5. Selecione Leitura/Escrita.
  6. Atualize a Consumer Key e a Consumer Secret no Chat Pró Oratrix.
  7. Salve.
  8. Faça um novo teste.

A imagem do produto não aparece

  1. Confirme se o arquivo está em JPG ou PNG.
  2. Verifique o tamanho da imagem.
  3. Teste com uma imagem de aproximadamente 800 x 800 pixels.
  4. Salve novamente.
  5. Atualize a página da loja.

O ticket não fecha ao concluir o pedido

  1. Acesse Configurações > Apps > WooCommerce.
  2. Edite a integração.
  3. Confirme se Fechar ticket ao completar pedido está ativo.
  4. Verifique se o pedido foi realmente alterado para Concluído.
  5. Aguarde a sincronização.
  6. Atualize o painel.
  7. Faça um novo teste.

:bar_chart: RESULTADO ESPERADO

Ao concluir o procedimento:

  • A loja WooCommerce estará integrada ao Chat Pró Oratrix.
  • Os webhooks estarão registrados.
  • Os novos pedidos aparecerão na Gestão Comercial.
  • Cada novo pedido poderá gerar um ticket.
  • A equipe poderá acompanhar os dados do pedido.
  • Os tickets serão direcionados para a fila ou usuário configurado.
  • Os produtos poderão ser consultados e gerenciados.
  • Os pedidos poderão ter o status atualizado.
  • O ticket poderá ser encerrado automaticamente quando o pedido for concluído.

:receipt: RESUMO FINAL

Com este procedimento, a loja WooCommerce será conectada ao Chat Pró Oratrix por meio das chaves da API REST e dos webhooks.

Depois de configurar o aplicativo e criar o Canal WooCommerce, os novos pedidos passarão a gerar tickets no painel.

Lembre-se de que esse canal serve somente para receber notificações. Para conversar com o comprador, utilize outro canal de atendimento.

:label: KEYWORDS

WooCommerce, pedidos, loja virtual, WordPress, Chat Pró Oratrix

:robot: Peça ajuda ao ChatGPT da Oratrix

A I.A. da Oratrix no ChatGPT poderá tirar dúvidas e te guiar passo a passo no suporte.