Conector Magento
Funciona com Magento
Conecte o Magento 2 ou Adobe Commerce ao FreeScout para que as conversas mostrem pedidos de clientes correspondentes e contexto de compra. Um pequeno módulo Magento somente leitura expõe um resumo de suporte pela REST API do Magento, e o conector do FreeScout o exibe na barra lateral da conversa. 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 Magento adiciona uma barra lateral de pedidos às conversas do FreeScout. Quando uma conversa tem um endereço de e-mail de cliente, o conector chama o moo-support/summary endpoint na sua loja Magento para correspondência de pedidos 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á dois componentes para instalar:
- O Módulo Conector ReplyRabbit para Magento 2. Adiciona dois endpoints REST somente leitura (
/rest/V1/moo-support/summarye/rest/V1/moo-support/purchased-products) por trás de uma permissão de administrador dedicada chamada API do Conector ReplyRabbit. Ele não altera a vitrine nem o checkout. - O Módulo conector Magento do FreeScout. Ele chama esses endpoints via HTTPS usando um token de acesso de integração do Magento e 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 Magento 2.4 ou posterior (Magento Open Source ou Adobe Commerce) acessível via HTTPS, com acesso SSH para executar comandos da CLI do Magento.
- Acesso administrativo ao Magento para criar uma Integração.
- ReplyRabbit instalado e ativado se você quiser contexto de propriedade de produto nos rascunhos de IA.
- Uma licença do Magento 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.
Instale o módulo Magento
Baixar o módulo Magento
Entre em app.replyrabbit.app e baixe o ZIP do módulo Magento no cartão do conector Magento.Descompacte em app/code
Envie o ZIP para a raiz do Magento e descompacte-o. Ele criaapp/code/Moogento/SupportData.Ativar o módulo
A partir da raiz do Magento, execute:Em uma loja em modo de produção, execute tambémbashbin/magento module:enable Moogento_SupportData bin/magento setup:upgrade bin/magento setup:di:compile bin/magento cache:flushbin/magento setup:static-content:deploycomo você faria para qualquer instalação de módulo.
Instalações do Composer
moogento/m2-supportdata do repositório de pacotes Moogento. A instalação por ZIP acima não requer credenciais do Composer.Criar um token de integração do Magento
O conector se autentica com um token de acesso de uma Integração do Magento. Crie uma com escopo para a permissão somente leitura do módulo.
Abrir Integrações
No admin do Magento, vá para Sistema, então Extensões, então Integrações, e clique em Adicionar Nova Integração.Dê um nome e defina o escopo da API
Digite um nome como "ReplyRabbit Connector" e sua senha de administrador. Na API aba, defina Acesso a Recursos para Personalizado e marque apenas API do Conector ReplyRabbit (sob a árvore de administração de nível superior). Salve.Ative e copie o token de acesso
Clique Ativar ao lado da nova integração, depois Permitir. Copie a Token de Acesso. O Magento mostra o token nos detalhes da integração, então você pode voltar a ele depois.
Acesso somente leitura
Instale o módulo conector do FreeScout
O módulo conector Magento do FreeScout chama os endpoints do Magento 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. Ambos os downloads aparecem 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 Integração Magento 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 Magento, 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 Magento, não uma seção dentro das configurações do ReplyRabbit.Digite a URL base do Magento
Cole a URL base da sua loja Magento via HTTPS, por exemplohttps://your-store.com. Uma barra final não é necessária.Digite o token de acesso
Cole o Token de Acesso da integração Magento. É armazenada criptografada, e apenas uma prévia mascarada é exibida após salvar.Defina o ID da loja (opcional)
Deixe em branco para corresponder a pedidos de todas as lojas. Insira um ID de loja Magento para limitar a barra lateral a uma loja ou visualização de loja.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 Magento e confirme que a barra lateral do pedido aparece.
Cada caixa de correio do FreeScout armazena sua própria URL base, token de acesso e ID de loja, então você pode conectar diferentes caixas de correio a diferentes lojas ou visualizações de loja do Magento.
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 Magento é um módulo pago. Você pode obtê-lo de duas formas:
- Compre o Magento 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 base e o token de acesso nas configurações do conector estão corretos e se o painel da caixa de correio está habilitado. |
| HTTP 404 da loja | O módulo ReplyRabbit Connector não está instalado ou habilitado. Execute novamente bin/magento module:enable Moogento_SupportData e bin/magento setup:upgrade, então limpe o cache. |
| HTTP 401 ou 403 da loja | A integração não está ativada, o token foi regenerado, ou a integração está sem o API do Conector ReplyRabbit recurso. Reative a integração e cole o token atual. |
| 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. |
| A URL base é rejeitada | A loja deve ser servida via HTTPS. Um http:// URL ou um host inacessível é recusado. |
| Os pedidos estão vazios para um cliente conhecido | Confirme se o e-mail do cliente na conversa do FreeScout corresponde ao e-mail nos pedidos do Magento e se o ID da loja (se definido) corresponde à loja onde ele fez o pedido. |
| 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 Magento, ele envia o endereço de e-mail do cliente para sua própria loja Magento 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.
O token da integração só precisa do API do Conector ReplyRabbit recurso, então o conector nunca grava na sua loja. O token é armazenado criptografado no FreeScout, e as requisições de saída verificam TLS e não seguem redirecionamentos.
Nenhum dado de pedido do Magento é 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.
- Também no WooCommerce? Veja o Conector WooCommerce guia.
FAQ
Preciso de um módulo Magento para o conector?
Sim. O conector lê um endpoint de resumo de suporte que o módulo ReplyRabbit Connector adiciona à API REST do Magento 2. Há dois downloads, o módulo Magento e o módulo conector Magento do FreeScout, ambos disponíveis na sua conta ReplyRabbit.
Quais versões do Magento são suportadas?
Magento 2.4 e posteriores, incluindo Magento Open Source e Adobe Commerce, em PHP 8.0 a 8.4. O Magento 1 não é suportado.
Quanto custa o Conector Magento?
O Conector Magento 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.
Que permissão o token de acesso precisa?
Apenas o recurso da API do Conector ReplyRabbit, que é somente leitura. O conector nunca grava na sua loja, então a integração não precisa de nenhuma outra permissão de admin.
Cada caixa de correio do FreeScout pode se conectar a uma loja Magento diferente?
Sim. Cada caixa de correio armazena sua própria URL base, token de acesso e ID de loja opcional nas configurações do conector, então diferentes lojas ou visualizações de loja podem se conectar a diferentes caixas de correio.