Guia de Integração: WooCommerce

Este guia detalha como conectar sua loja WooCommerce ao Conversaas, permitindo que a inteligência artificial interaja com os dados da sua loja para recuperar carrinhos e buscar produtos.

1. Pré-Requisitos

• WordPress versão 5.4 ou superior.
• Plugin do WooCommerce instalado e ativo (versão 4.0+).
• Permissões de Administrador no painel do WordPress.

2. Instalação

O Conversaas possui um plugin oficial desenvolvido em PHP que automatiza a integração da sua loja.

1. Baixe o plugin oficial do Conversaas.
2. Acesse o painel do seu WordPress e vá em Plugins > Adicionar Novo.
3. Clique em Enviar Plugin e selecione o arquivo baixado.
4. Clique em Instalar Agora e, após a conclusão, em Ativar.
5. No menu lateral do WordPress, vá para Conversaas > Configurações.
6. Insira a sua API Key do Conversaas (você encontra no painel do Conversaas em Configurações > Integrações).

3. Funcionalidades Disponíveis

• Recuperação de Carrinho Abandonado: [DISPONÍVEL] O agente dispara mensagens para leads que deixaram itens no carrinho de compras.
• Notificações de Pedido: [DISPONÍVEL] Atualiza o cliente via WhatsApp sobre o status do pedido (Confirmado, Pago, Enviado).
• Consulta de Catálogo pelo Agente: [DISPONÍVEL] Permite que o bot busque informações, variações e preços dos produtos diretamente na loja.

4. Webhooks

A configuração dos Webhooks é feita automaticamente pelo plugin assim que você insere sua API Key. O envio cobre os seguintes eventos:

• woocommerce_order_status_completed
• woocommerce_order_status_processing
• conversaas_cart_abandoned (evento exclusivo do plugin)

Exemplo de payload de carrinho:

{
  "event": "cart_abandoned",
  "customer": {
    "name": "João",
    "phone": "+5511999999999"
  },
  "cart_url": "https://sualoja.com/checkout/...",
  "items": [
    { "product_id": 123, "name": "Camiseta Branca", "price": 49.90 }
  ]
}

5. Testando a Integração

1. Inicie uma navegação anônima na sua loja.
2. Adicione um produto ao carrinho.
3. Preencha seus dados de contato no checkout, incluindo um telefone válido (WhatsApp).
4. Feche a aba do checkout e aguarde o tempo configurado (geralmente de 15 a 30 minutos).
5. Verifique no painel do Conversaas, em CRM & Leads ou "Histórico de Conversas", se a mensagem de recuperação foi despachada.

6. Perguntas Frequentes da Integração

A integração afeta a performance da loja?
Não. O plugin foi desenhado (dividido em 12 arquivos modulares) para ter zero impacto no carregamento do site. Os disparos para o Conversaas são assíncronos.

O que acontece se a loja ficar offline?
O Conversaas tentará manter as interações ativas e responder os clientes. Carrinhos abandonados já registrados continuarão processando internamente nosso CRM. Apenas consultas em tempo real ao catálogo ficarão indisponíveis até o retorno da loja.

Como desativar temporariamente sem perder a configuração?
No painel do WordPress, vá em Conversaas > Configurações e marque a opção "Pausar Integração". Você também pode pausar pelo próprio painel do Conversaas em Canais > Integrações.