Integração com o WooCommerce

A integração com o WooCommerce no Deskwoot traz o histórico de pedidos do cliente, as compras de produtos e os detalhes da conta para a barra lateral da conversa, para que os agentes e o bot de IA respondam a dúvidas sobre pedidos com contexto. A configuração usa uma chave de API do WooCommerce gerada no painel de administração da sua loja. Seus agentes de suporte ganham contexto completo sem trocar de aba, e seu bot de IA consegue consultar informações de pedidos ao responder às perguntas dos clientes. Este guia mostra a configuração, o que esperar depois de conectar e como resolver problemas comuns.

Gerando chaves de API no WooCommerce

1. No seu painel do WordPress, acesse WooCommerce > Configurações > Avançado > REST API.
2. Clique em Adicionar chave.
3. Informe uma descrição (por exemplo, Deskwoot Integration), selecione um usuário com privilégios de administrador e defina as permissões como Leitura/Escrita se a sua equipe for reembolsar e cancelar pedidos pelo Deskwoot, ou Leitura se você só quiser ver os pedidos.
4. Clique em Gerar chave de API.
5. Copie imediatamente tanto a Consumer Key quanto o Consumer Secret. Eles são exibidos apenas uma vez.

Dica: guarde as chaves em um local seguro antes de fechar a página. Se você perdê-las, precisará gerar um novo par.

Conectando no Deskwoot

1. No Deskwoot, vá em Configurações > Integrações > WooCommerce.
2. Informe a URL do seu site WooCommerce (por exemplo, https://yourstore.com), a Consumer Key e o Consumer Secret.
3. Clique em Conectar.

O Deskwoot verifica a conexão buscando uma requisição de teste na sua loja. Depois de verificada, os dados de pedidos e clientes começam a aparecer no seu espaço de trabalho.

Histórico de pedidos nas conversas

Depois de conectada, a seção Pedidos na aba Detalhes da conversa exibe os 10 pedidos mais recentes do cliente, incluindo número do pedido, status, valor total e data. Clique em qualquer pedido para ver os itens, o endereço de entrega e as informações de rastreamento (o rastreamento precisa do plugin gratuito WooCommerce Shipment Tracking). Os pedidos são associados pelo endereço de e-mail do cliente. Com uma chave de Leitura/Escrita a seção também oferece Reembolsar, Cancelar pedido e Marcar como enviado.

Sincronização dos dados do cliente

O Deskwoot importa seus clientes do WooCommerce como contatos ao conectar e depois uma vez por dia, incluindo nome, e-mail, telefone, empresa, cidade e país, e total gasto. Esses dados enriquecem os perfis de contato e ajudam os agentes a oferecer um suporte personalizado.

Contexto para o bot de IA

Quando o bot de IA está ativado, ele recebe automaticamente o contexto dos pedidos do cliente atual. Isso permite que ele responda a perguntas como "Onde está meu pedido?" ou "O que pedi da última vez?" sem intervenção do agente.

Quando um visitante que não foi verificado pergunta onde está um pedido, o Fynn pede o número do pedido e o CEP do endereço de entrega (ou do endereço de cobrança, quando o pedido não tem endereço de entrega). Isso funciona para todo pedido da sua loja, também para um feito antes de você conectá-la: um pedido que o Deskwoot ainda não guardou é procurado direto no WooCommerce. Quando o número e o CEP não batem, o Fynn pede ao cliente que confira os dois e depois oferece a confirmação por e-mail. Para isso, ative Orders & transactions (via Shopify/Stripe/WooCommerce) em Data Access, nas configurações do bot (Configurações > Bots).

Solução de problemas

• A conexão falha durante a verificação: confira se a URL do seu site inclui https:// e não tem barra no final. Confirme se a REST API está acessível e não está bloqueada por um plugin de segurança ou regra de firewall.
• Nenhum pedido aparece na barra lateral: verifique se o endereço de e-mail do cliente na conversa coincide com o e-mail da conta dele no WooCommerce. Os pedidos são associados pelo e-mail, então divergências resultam em dados ausentes.
• Erros de permissão: confirme se a chave de API foi criada com um usuário que tem privilégios de administrador. Reembolsos e cancelamentos pelo Deskwoot precisam de permissões de Leitura/Escrita.

Boas práticas

• Use uma conta de usuário dedicada do WordPress para a chave de API, assim você pode revogar o acesso sem afetar outras integrações.
• Escolha Leitura se você só quiser ver os pedidos no Deskwoot. Escolha Leitura/Escrita apenas se a sua equipe for reembolsar, cancelar ou marcar pedidos como enviados pelo Deskwoot.
• Revise periodicamente suas chaves da REST API do WooCommerce e remova as que não estão mais em uso.

Perguntas frequentes