Conector Shopify
Funciona com Shopify
Conecte o Shopify ao FreeScout para que as conversas mostrem pedidos de clientes correspondentes e contexto de compra. Você cria um app personalizado somente leitura no seu admin do Shopify e cola o token de acesso no FreeScout, então não há conta de parceiro nem revisão de app envolvida. 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 Shopify adiciona uma barra lateral de pedidos às conversas do FreeScout. Quando uma conversa tem um endereço de e-mail de cliente, o conector consulta a API GraphQL Admin do Shopify na sua loja em busca de pedidos correspondentes e os mostra 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 Shopify do FreeScout. Ele lê a GraphQL Admin API do Shopify via HTTPS usando um token de acesso da Admin API de um app personalizado 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 Shopify em um
your-store.myshopify.comdomínio (ou um domínio personalizado que mapeie para um), com permissões de equipe para desenvolver aplicativos. - ReplyRabbit instalado e ativado se você quiser contexto de propriedade de produto nos rascunhos de IA.
- Uma licença do Shopify 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.
Criar um app personalizado no Shopify
O conector se autentica com um token de acesso da API Admin de um app personalizado que fica dentro da sua própria loja.
Abrir Desenvolver apps
No admin do Shopify, vá para Configurações, então Aplicativos e canais de vendas, então Desenvolver aplicativos. Se solicitado, permita o desenvolvimento de apps personalizados.Criar o app
Clique Criar um app, dê o nome "ReplyRabbit Connector" e crie-o.Defina os escopos da Admin API
Abrir Configurar escopos da Admin API e marqueread_customers,read_orders, eread_products. Marqueread_all_orderstambém se você quiser histórico de pedidos com mais de 60 dias. Salve.Instale e copie o token
Clique Instalar app, então Revelar token uma vez e copie o Token de acesso da API de administrador (começa comshpat_). O Shopify o mostra apenas uma vez, então guarde-o em um local seguro.
Acesso somente leitura
Instale o módulo conector do FreeScout
Baixar o módulo conector
Baixe o ZIP do módulo conector do FreeScout em Painel do ReplyRabbit. O download aparece depois que você compra 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 Shopify módulo da lista de Módulos.
Configurar por caixa de correio
Abra as configurações do conector
No FreeScout, abra a caixa de correio que deve mostrar dados de pedidos do Shopify, 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 Shopify, não uma seção dentro das configurações do ReplyRabbit.Digite o domínio da loja e o token de acesso
Digite o domínio da sua loja, por exemployour-store.myshopify.com, e cole o token de acesso da Admin API. Salve. O conector verifica o token e os escopos na sua loja antes de armazená-lo; o token é armazenado criptografado e nunca é mostrado novamente.Adicione sua chave de licença do conector
Se você comprou o conector, definaSHOPIFYINTEGRATION_LICENSE_KEYno seu FreeScout.envpara sua chave de licença. Pule esta etapa se um plano ReplyRabbit Pro ou Team ativo cobrir a instalação.Testar
Abra uma conversa do FreeScout em que o e-mail do cliente corresponda a um pedido Shopify e confirme que a barra lateral do pedido aparece.
Cada caixa de correio do FreeScout armazena seu próprio domínio de loja e token de acesso, então você pode conectar diferentes caixas de correio a diferentes lojas.
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 Shopify é um módulo pago. Você pode obtê-lo de duas formas:
- Compre o Shopify Connector por 18 EUR como licença única para uma instalação do FreeScout e depois defina a chave de licença como
SHOPIFYINTEGRATION_LICENSE_KEYno FreeScout.env. - 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 |
|---|---|
| "O Shopify rejeitou a conexão" ao salvar | O token foi digitado incorretamente, revogado ou pertence a uma loja diferente. Revele um novo token reinstalando o aplicativo personalizado e cole-o novamente. |
| "Faltam estes escopos da Admin API" ao salvar | Abra o aplicativo personalizado e adicione os escopos ausentes em Configurar escopos da Admin API, salve e reinstale o app. A reinstalação emite um novo token. |
| Domínio da loja rejeitado | Use o your-store.myshopify.com domínio, ou um domínio personalizado que mapeie para ele. Hosts privados e endereços IP são recusados. |
| A barra lateral do pedido não aparece | Confirme se o painel da caixa de correio está habilitado e se a conexão aparece como conectada na página de configurações. |
| 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 Shopify. |
| Apenas os últimos 60 dias de pedidos aparecem | Adicione o read_all_orders escopo para o app personalizado, reinstale-o e cole o novo token. |
| 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 Shopify, ele envia o endereço de e-mail do cliente para a API GraphQL Admin do Shopify via HTTPS usando o token do seu app personalizado. 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 app personalizado tem apenas escopos de leitura, então o conector nunca grava na sua loja. O token de acesso é armazenado criptografado no FreeScout, e as requisições de saída verificam TLS e não seguem redirecionamentos.
Nenhum dado de pedido do Shopify é 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 ou Magento? Veja o Conector WooCommerce e Conector Magento guias.
FAQ
Como o conector Shopify se conecta à minha loja?
Com um app personalizado que você cria no admin do Shopify (Configurações, Apps e canais de vendas, Desenvolver apps). Conceda a ele os escopos read_customers, read_orders e read_products, instale-o e cole seu token de acesso da Admin API com o domínio da sua loja nas configurações do conector do FreeScout. O conector verifica o token contra sua loja antes de salvá-lo.
Preciso de uma conta de parceiro Shopify ou de uma listagem na App Store?
Não. Um app personalizado é criado dentro do admin da sua própria loja e não precisa de conta de Parceiro, nem de revisão de app, nem de listagem pública.
Quanto custa o Conector Shopify?
O Conector Shopify 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, defina sua chave de licença como SHOPIFYINTEGRATION_LICENSE_KEY no seu .env do FreeScout.
Por que só vejo pedidos dos últimos 60 dias?
O Shopify limita os apps a 60 dias de histórico de pedidos, a menos que o app tenha o escopo read_all_orders. Marque read_all_orders ao configurar o app personalizado para ver o histórico completo.
Cada caixa de correio do FreeScout pode se conectar a uma loja Shopify diferente?
Sim. Cada caixa de correio armazena seu próprio domínio de loja e token de acesso nas configurações do conector, então diferentes lojas podem se conectar a diferentes caixas de correio.