
Conector WooCommerce
Funciona com WooCommerce
Conecte o WooCommerce ao FreeScout para que as conversas mostrem pedidos de clientes correspondentes e contexto de compra. O conector se comunica diretamente com a REST API do WooCommerce, então não há plugin do lado da loja para instalar. O ReplyRabbit também alimenta o contexto de propriedade de produto na camada de IA para que os rascunhos possam referenciar o que um cliente comprou.
Procurando a visão geral?
Visão geral
O conector WooCommerce adiciona uma barra lateral de pedidos às conversas do FreeScout. Quando uma conversa tem um endereço de e-mail do cliente, o conector consulta a API REST do WooCommerce (wc/v3) na sua loja para pedidos correspondentes e os exibe ao lado da conversa.
A barra lateral mostra um painel do cliente, histórico completo de pedidos, itens por pedido com quantidades e preços, totais financeiros, valor de vida do cliente (CLV), valor médio do pedido (AOV) e direito de propriedade de produtos que flui para o contexto de IA do ReplyRabbit para rascunhos mais relevantes.
Há um componente para instalar: o Módulo conector WooCommerce do FreeScout. Ele lê a REST API do WooCommerce via HTTPS usando uma chave e um segredo de consumidor e, em seguida, renderiza a barra lateral do pedido. Ele tem sua própria página de configurações por caixa de correio no FreeScout.
A barra lateral de pedidos funciona sozinha. O direito de propriedade de produtos que flui para os rascunhos de IA é a parte que usa o ReplyRabbit.
Pré-requisitos
Antes de começar, certifique-se de ter:
- Uma instalação funcional do FreeScout.
- Uma loja WooCommerce acessível via HTTPS, com acesso de administrador para criar chaves de API REST.
- Uma loja que não está atrás de Autenticação HTTP Básica em todo o site, que entra em conflito com o cabeçalho de autenticação da API REST.
- ReplyRabbit instalado e ativado se você quiser contexto de propriedade de produto nos rascunhos de IA.
- Uma licença do WooCommerce Connector (18 EUR pagamento único, para uma instalação do FreeScout), ou um plano ReplyRabbit Pro ou Team ativo, que a inclui.
Se o ReplyRabbit ainda não estiver instalado, comece com Como instalar o módulo ReplyRabbit, então conclua Como configurar o ReplyRabbit.
Gerar chaves de API REST do WooCommerce
O conector se autentica com uma chave da API REST do WooCommerce, composta por uma chave de consumidor e um segredo de consumidor. Crie a chave no administrador do WordPress.
Abra as configurações da API REST
No admin do WordPress, vá para WooCommerce, então Configurações, então Avançado, então API REST.Adicionar uma chave
Clique Adicionar chave. Insira uma descrição como "ReplyRabbit Connector", defina Permissões para Ler, e clique em Gerar chave de API.Copie a consumer key e o secret
Copie o Consumer key e Consumer secret. O WooCommerce mostra o segredo uma vez, então guarde ambos os valores em um local seguro antes de sair da página.
Acesso somente leitura
Instale o módulo conector do FreeScout
O módulo conector WooCommerce do FreeScout consulta a API REST do WooCommerce e renderiza a barra lateral de pedidos nas conversas. É um módulo próprio, com configurações próprias, separado do ReplyRabbit.
Baixar o módulo conector
Entre em app.replyrabbit.app para baixar o ZIP do módulo conector do FreeScout. O download aparece depois que você comprou o conector ou tem um plano ReplyRabbit Pro ou Team ativo.Enviar para o FreeScout
No FreeScout, vá para Módulos, clique no botão de upload, escolha o ZIP e instale-o.Ative o módulo
Ative o WooCommerce módulo da lista de Módulos.
Configurar por caixa de correio
Depois que o módulo estiver instalado, conecte-o à sua loja na página de configurações por caixa de correio do próprio conector.
Abra as configurações do conector
No FreeScout, abra a caixa de correio que deve mostrar dados de pedidos do WooCommerce, abra o menu de configurações da caixa de correio e escolha Conector de Loja. Esta é a página de configurações do conector do WooCommerce, não uma seção dentro das configurações do ReplyRabbit.Digite a URL da loja
Cole a URL base da sua loja WooCommerce via HTTPS, por exemplohttps://your-store.com. Uma barra final não é necessária.Digite a consumer key e o secret
Cole o Consumer key e Consumer secret que você gerou no WooCommerce. Eles são armazenados criptografados, e apenas uma prévia mascarada é exibida após salvar.Adicione sua chave de licença do conector
Se você comprou o conector, insira a chave de licença dele. Pule esta etapa se um plano ReplyRabbit Pro ou Team ativo cobrir a instalação.Salvar e testar
Salve as configurações. Abra uma conversa no FreeScout em que o e-mail do cliente corresponda a um pedido do WooCommerce e confirme que a barra lateral do pedido aparece.
Cada caixa de correio do FreeScout armazena sua própria URL da loja e chaves de API REST, então você pode conectar diferentes caixas de correio a diferentes lojas WooCommerce.
O que o conector mostra
- Um painel do cliente para a pessoa na conversa.
- Histórico completo de pedidos com número do pedido, data, status e total.
- Itens de linha por pedido com quantidades e preços.
- Totais financeiros (subtotal, desconto, frete, imposto, reembolsos).
- Valor de vida do cliente (CLV) e valor médio do pedido (AOV).
- Direito de uso do produto para rascunhos de IA.
Como obter o conector
O Conector WooCommerce é um módulo pago. Você pode obtê-lo de duas formas:
- Compre o WooCommerce Connector por 18 EUR como licença única para uma instalação do FreeScout e depois cole a chave de licença nas configurações do conector.
- Use um plano ReplyRabbit Pro ou Team ativo, que inclui o conector sem custo adicional.
Compre a licença ou baixe o conector na sua Painel do ReplyRabbit. Visite a página de preços para opções de plano do ReplyRabbit. Se um plano ReplyRabbit Pro ou Team ativo cobrir a instalação, o conector funciona assim que for configurado, sem necessidade de chave de licença separada.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| A barra lateral do pedido não aparece | Confirme se a URL da loja, a consumer key e o consumer secret nas configurações do conector estão corretos e se o painel da caixa de correio está habilitado. |
| Erro "Connection refused" ou de tempo limite | Verifique se o servidor do FreeScout consegue alcançar a URL da sua loja via HTTPS. Firewalls, listas de IP permitidos ou modo de manutenção podem bloquear a solicitação. |
| URL da loja rejeitada | A loja deve ser servida via HTTPS. Um http:// URL ou um host inacessível é recusado. |
| A autenticação falha | Confirme se a loja não está protegida por Basic HTTP Authentication em todo o site, o que intercepta o cabeçalho de autenticação da REST API antes que o WooCommerce o veja. |
| Consumer key ou secret rejeitado | Regenere a chave no WooCommerce em Configurações, então Avançado, então API REST, com Ler permissão, e cole a nova consumer key e o secret nas configurações do conector. |
| Os pedidos estão vazios para um cliente conhecido | Confirme se o e-mail do cliente na conversa do FreeScout corresponde ao e-mail de cobrança nos pedidos do WooCommerce. |
| Itens de linha, financeiros ou CLV não estão aparecendo | Confirme se a chave de licença do conector está salva ou se um plano ReplyRabbit Pro ou Team ativo cobre a instalação. |
| Contexto de propriedade do produto não aparece nos rascunhos | Confirme se o conector está licenciado, se o ReplyRabbit está instalado, se o conector está retornando pedidos e se o recurso de contexto de IA está habilitado para a caixa de correio. |
Para problemas mais amplos, consulte Solução de problemas do ReplyRabbit.
Privacidade e tratamento de dados
Quando o conector consulta o WooCommerce, ele envia o endereço de e-mail do cliente para sua própria API REST do WooCommerce via HTTPS. Os dados de pedido retornados da sua loja preenchem a barra lateral do FreeScout e, com o ReplyRabbit, constroem o contexto de IA para rascunhos.
A chave da API REST precisa apenas de Ler permissão, então o conector nunca grava na sua loja. A consumer key e o secret são armazenados criptografados no FreeScout, e as requisições de saída verificam TLS e não seguem redirecionamentos.
Nenhum dado de pedido do WooCommerce é enviado a terceiros, exceto pelo provedor de IA selecionado para a caixa de correio, e somente quando o recurso de contexto de IA o utiliza. Se sua política exigir que os dados de pedidos permaneçam inteiramente nos seus próprios servidores, use um provedor de IA local (como Ollama) para a caixa de correio.
Próximos passos
- Concluir Como configurar o ReplyRabbit se a caixa de correio ainda precisa de configurações de provedor, contexto ou estilo.
- Veja Como instalar o módulo ReplyRabbit se você ainda não instalou o ReplyRabbit.
FAQ
Preciso de um plugin WordPress para o conector WooCommerce?
Não. O conector fala diretamente com a REST API do WooCommerce. Você gera uma chave da REST API no WooCommerce e insere a URL da loja, a consumer key e o consumer secret no conector do FreeScout. Há um único download, o módulo conector WooCommerce para FreeScout.
Quanto custa o Conector WooCommerce?
O Conector WooCommerce está incluído em um plano ReplyRabbit Pro ou Team ativo. Caso contrário, custa 18 EUR como licença única para uma instalação do FreeScout. Se você comprá-lo, cole a chave de licença nas configurações do conector.
Como o conector corresponde aos clientes?
O conector consulta pedidos do WooCommerce pelo endereço de e-mail do cliente na conversa do FreeScout. Para propriedade de produtos, ele também verifica e-mails vinculados e, como fallback de melhor esforço, outros pedidos pagos no mesmo domínio de e-mail.
Que permissão a chave da API REST precisa?
Somente leitura. O conector nunca grava na sua loja, então uma chave com permissão de Leitura é suficiente.
Cada caixa de correio do FreeScout pode se conectar a uma loja WooCommerce diferente?
Sim. Cada caixa de correio armazena sua própria URL de loja e chaves da API REST nas configurações do conector, então diferentes lojas podem se conectar a diferentes caixas de correio.