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
- No seu painel do WordPress, acesse WooCommerce > Configurações > Avançado > REST API.
- Clique em Adicionar chave.
- Informe uma descrição (por exemplo,
Deskwoot Integration), selecione um usuário com privilégios de administrador e defina as permissões como Leitura. - Clique em Gerar chave de API.
- 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
- No Deskwoot, vá em Configurações > Integrações > WooCommerce.
- Informe a URL do seu site WooCommerce (por exemplo,
https://yourstore.com), a Consumer Key e o Consumer Secret. - 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 barra lateral da conversa exibe os pedidos 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. Os pedidos são associados pelo endereço de e-mail do cliente.
Sincronização dos dados do cliente
O Deskwoot sincroniza os dados do cliente a partir do WooCommerce, incluindo nome, e-mail, endereço de cobrança 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.
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 e se as permissões estão definidas como Leitura.
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.
- Defina as permissões apenas como Leitura. O Deskwoot não precisa de acesso de escrita à sua loja.
- Revise periodicamente suas chaves da REST API do WooCommerce e remova as que não estão mais em uso.
Perguntas frequentes
Posso conectar várias lojas WooCommerce?
Cada loja exige o seu próprio conjunto de chaves de API. Repita os passos acima para cada loja que quiser conectar.
Com que rapidez os dados de pedidos aparecem no Deskwoot?
Os dados de pedidos são buscados em tempo real quando uma conversa é aberta, então os agentes sempre veem as informações mais atuais.
Meus dados do WooCommerce estão seguros?
O Deskwoot se comunica com a sua loja por HTTPS usando as credenciais de API que você fornece. Apenas acesso de leitura é solicitado, então nenhuma alteração pode ser feita na sua loja por meio da integração.