Pular para o conteúdo principal

Guia de Integração: Shopify

Conecte a infraestrutura da Shopify ao Conversaas e extraia os melhores resultados otimizando o contato instantâneo de abandono de itens de clientes em sua loja.

1. Pré-Requisitos​

  • Loja ativa na rede Shopify.
  • Acesso total administrativo para configurar Aplicativos Personalizados (Custom Apps) já que a instalação via Store Oficial está em homologação.

2. Instalação​

NOTA: A instalação nativa (1-Click Install via App Store) está em fase de lançamento. O formato atual é via Aplicativo Personalizado (Custom App).

  1. No painel da Shopify, acesse Settings > Apps and sales channels > Develop apps for your store.
  2. Clique em Create an app e chame-o de "Conversaas Integrator".
  3. Configure os API scopes do Admin API Integration para Leitura (Read_only) nas categorias: read_orders, read_products, read_customers.
  4. Instale o Aplicativo Desenvolvido. Isso irá gerar o Admin API access token (começando com shpat_...).
  5. No painel do Conversaas, vá em Integrações > Canais Ecommerce > Shopify.
  6. Cole a URL da Loja (exemplo: sualoja.myshopify.com) e o Access Token copiado do passo anterior.
  7. Clique em Conectar.

3. Funcionalidades Disponíveis​

  • Recuperação de Carrinho Abandonado: [DISPONÍVEL] A Shopify captura as interrupções de checkout e notifica o Conversaas para o agente engajar o prospecto.
  • Notificações de Pedido: [DISPONÍVEL] Automações para informar via WhatsApp ao confirmar pagamento, embalar e entregar o pacote.
  • Consulta de Catálogo pelo Agente: [EM BREVE] A consulta detalhada com o motor de busca (variação de tamanhos, cores, imagens da Shopify) será liberada na próxima atualização maior do sistema.

4. Webhooks​

A configuração do webhook nativo do Shopify é gerada automaticamente depois de inserido o Token. A API da Shopify despachará atualizações para nosso sistema.

Eventos de webhook nativos:

  • checkout/create
  • checkout/update
  • orders/create
  • orders/paid

Exemplo de Payload de Carrinho Abandonado:

{
  "id": 123456,
  "token": "ab12xc34",
  "abandoned_checkout_url": "https://sualoja.myshopify.com/...",
  "customer": {
    "phone": "+5511999999999"
  }
}

5. Testando a Integração​

  1. Como logado ou como visitante anônimo (sugerido usar o ambiente "Bogus Gateway" para evitar custos), coloque itens no carrinho e avance até a tela final de frete / formas de pagamento.
  2. Aguarde entre 15 a 30 minutos (tempo padrão da Shopify para classificar inatividade e engatilhar webhook do carrinho).
  3. Confira na plataforma Conversaas se a notificação foi capturada e exibida em CRM & Leads ou nos Logs.
  4. Em caso de falha de conexão inicial, revalide as permissões de escopo read_orders no App Desenvolvido da sua loja Shopify.

6. Perguntas Frequentes da Integração​

A integração afeta a performance da loja?
Não há interferência na velocidade. Não colocamos nenhum JavaScript extra ou tags intrusivas no layout da sua loja (Liquid Templates).

O que acontece se a loja ficar offline?
Se houverem interrupções na própria infraestrutura Shopify (raro), o Conversaas pausará checagens até a volta.

Como desativar temporariamente sem perder a configuração?
Dentro do Conversaas (Integrações > Shopify), use a interface para suspender integrações ativas. Caso queira encerrar definitvamente, você pode desinstalar o "App" manualmente dentro das configurações de apps da Shopify.