Guia de Habilidades de IA no Easy Digital Downloads

Você gostaria de saber exatamente o que um assistente de IA pode fazer com sua loja antes de conectar um? O Easy Digital Downloads descreve cada operação da loja para seu assistente como uma habilidade nomeada, então tudo o que ele pode alcançar é listado em vez de adivinhado. Cada habilidade cobre um trabalho, como ler um relatório de vendas ou criar um código de desconto.

Este guia o orienta por todas as habilidades que sua loja pode expor e o que cada uma lê ou altera.

Antes de começar, certifique-se de que o Easy Digital Downloads esteja instalado e ativado em seu site WordPress e que você tenha conectado sua loja a um assistente de IA.

Requisitos: Easy Digital Downloads 3.7.1 ou mais recente, executando no WordPress 6.9 ou mais recente.

Como Funcionam as Habilidades da Loja?

Cada habilidade é registrada na API de Habilidades do WordPress sob um nome que seu assistente vê, como edd/sales-report. Seu assistente lê essa lista, escolhe a habilidade que corresponde ao que você pediu e a executa nos dados da sua própria loja.

As habilidades se dividem em dois grupos, e a diferença importa mais do que qualquer outro detalhe nesta página. As habilidades de leitura consultam informações e não alteram nada. As habilidades de escrita criam ou editam registros, e só são executadas quando Permitir que a IA altere dados da loja está ativado.

Seu assistente também vê um rótulo curto em cada uma. As habilidades de leitura são marcadas como somente leitura, e o punhado de habilidades de escrita cujos resultados não podem ser desfeitos são marcadas como destrutivas, que é o sinal que os assistentes usam para pedir sua permissão antes de executá-las.

Com essa divisão em mente, veja o que cada grupo abrange.

Consultando Informações da Loja

Estas funcionam assim que sua loja é conectada, e nenhuma delas toca em seus dados.

Pedidos

• Ler Pedidos (edd/order-read) consulta um único pedido por ID, incluindo seus itens, ou lista pedidos filtrados por status, cliente, produto, endereço de e-mail ou intervalo de datas. As listas contêm vendas, a menos que você solicite reembolsos em vez disso.
• Ler Notas de Pedido (edd/order-note-read) lista as notas registradas em um pedido, da mais recente para a mais antiga.

Clientes

• Ler Clientes (edd/customer-read) consulta um cliente por ID ou endereço de e-mail, ou pesquisa e lista clientes. Endereços de e-mail e dados de endereço são incluídos apenas para contas autorizadas a visualizar dados confidenciais da loja.
• Ler Notas de Cliente (edd/customer-note-read) lista as notas registradas em um cliente, da mais recente para a mais antiga.

Produtos

• Ler Produtos (edd/product-read) consulta um produto por ID, incluindo seus preços, arquivos e limite de download, ou lista produtos filtrados por termo de busca, status, categoria ou tag.

Descontos

• Ler Descontos (edd/discount-read) consulta um desconto por ID ou código, ou lista descontos filtrados por status, tipo ou termo de busca. Descontos arquivados são omitidos, a menos que você solicite um status específico.

Relatórios

• Relatório de Vendas (edd/sales-report) retorna estatísticas de vendas e ganhos para um período predefinido ou um intervalo de datas personalizado, e pode ser limitado a um único produto.
• Resumo de Vendas (edd/sales-summary) retorna ganhos líquidos e contagens de vendas para este mês, mês passado, hoje e todo o tempo.

Configuração da loja

• Configurações da Loja (edd/settings) retorna um resumo somente leitura da sua configuração: moeda, gateways de pagamento, impostos, páginas principais e informações de versão.
• Taxas de Imposto (edd/tax-rates) lista suas taxas de imposto e se os impostos estão habilitados, e a lista pode ser filtrada por país.
• Verificação de Integridade da Loja (edd/health-check) retorna um instantâneo da integridade da loja: versões de software, modo da loja, contagens de pedidos e clientes, e gateways de pagamento habilitados.

Logs

• Logs de Download de Arquivos (edd/download-log) lista registros de download de arquivos, filtrados por produto, cliente, pedido ou intervalo de datas.
• Logs de E-mail (edd/email-log) lista os e-mails que sua loja enviou, filtrados por destinatário, ID de e-mail, objeto relacionado ou intervalo de datas.

Esses cobrem todas as perguntas que um assistente pode responder sem alterar nada. O próximo grupo é aquele que o controle de escrita governa.

Fazendo Alterações na Sua Loja

Esses permanecem indisponíveis até que Permitir que a IA altere dados da loja esteja ativado, e cada um ainda respeita o que a conta conectada tem permissão para fazer.

Pedidos

• Criar Pedido (edd/order-create) registra um pedido manual para um cliente, usando um ID de cliente existente ou um endereço de e-mail. Os preços dos itens vêm dos produtos, e um código de desconto opcional se aplica a todo o pedido. Nenhum pagamento é coletado, os impostos não são calculados e as restrições de desconto em nível de produto não são aplicadas. O recibo do cliente e a notificação de nova venda da sua loja são enviados, a menos que a solicitação peça um pedido silencioso. Este é marcado como destrutivo.
• Atualizar Status do Pedido (edd/order-update-status) altera o status de um pedido, disparando os mesmos hooks do administrador. Concluir um pedido envia um recibo por e-mail ao cliente e concede acesso ao download, e mover um pedido concluído para trás subtrai dos ganhos da loja e dos totais do cliente. Este é marcado como destrutivo.
• Reenviar Recibo do Pedido (edd/order-resend-receipt) envia o recibo de compra novamente, para o endereço de e-mail do pedido.
• Adicionar Nota ao Pedido (edd/order-note-add) adiciona uma nota interna a um pedido. As notas nunca são enviadas ao cliente.

Observação: Reembolsos não fazem parte desta lista. Eles permanecem na tela do pedido em seu administrador, para que um assistente não possa emitir um.

Clientes

• Criar Cliente (edd/customer-create) adiciona um registro de cliente a partir de um endereço de e-mail, com um nome opcional. Ele para se um cliente já existir com esse endereço.
• Atualizar Cliente (edd/customer-update) altera o nome, o endereço de e-mail principal ou o status de um cliente existente.
• Adicionar Nota ao Cliente (edd/customer-note-add) adiciona uma nota interna a um registro de cliente.

Produtos

• Criar Produto (edd/product-create) adiciona um produto com um preço único opcional. Novos produtos são rascunhos, a menos que a solicitação peça que sejam publicados, então nada chega à sua vitrine até que você o revise.
• Atualizar Produto (edd/product-update) altera apenas os campos que a solicitação nomeia: título, preço único, status ou descrição.

Descontos

• Criar Desconto (edd/discount-create) cria um código de porcentagem ou valor fixo, com datas de início e fim, limites de uso, um valor mínimo de pedido e requisitos ou exclusões de produtos. Novos códigos ficam inativos, a menos que a solicitação diga o contrário, então você tem a chance de revisar um antes que os clientes possam usá-lo.
• Atualizar Desconto (edd/discount-update) altera apenas os campos que a solicitação nomeia: nome, valor, status, limite de uso, datas, valor mínimo do pedido ou a configuração de uma vez por cliente.
• Excluir Desconto (edd/discount-delete) remove um desconto que nunca foi usado. Um código com usos registrados é arquivado em vez disso. Este é marcado como destrutivo.

Cada alteração de pedido e cliente também registra uma nota no próprio registro, nomeando a capacidade e a conta que utilizou, o que O que um Assistente de IA Conectado Pode Ver e Alterar cobre em detalhes.

Habilidades Que Dependem de Outros Recursos

Sua loja descreve apenas o que ela pode realmente fazer, então estes três aparecem quando o recurso por trás deles está em execução e permanecem ocultos quando não está.

• Obter Link da Fatura (edd/invoice-link) retorna o URL da fatura de um pedido, pronto para compartilhar com o cliente. Ele aparece quando Faturas está disponível.
• Ler Carrinhos Abandonados (edd/abandoned-cart-read) lista os carrinhos que foram abandonados, seus totais e quantos itens eles continham. Ele aparece quando a Recuperação de Carrinho está ativada.
• Ler Campanhas (edd/campaign-read) relata quais campanhas estão gerando vendas. Ele aparece quando o Rastreador de Campanhas está ativado.

Todos os três leem informações em vez de alterá-las. Eles também aparecem como um cartão de Crescimento na aba de IA, então a aba é a maneira mais rápida de saber quais deles sua própria loja está oferecendo.

Licenciamento de Software e Pagamentos Recorrentes adicionam suas próprias habilidades da mesma forma. Cada um ganha sua própria seção abaixo.

Habilidades de Licenciamento de Software

Se você vende software com Licenciamento de Software, seu assistente pode ajudar com as perguntas sobre licenças que os clientes mais fazem. Ele pode verificar quando uma chave expira e ver em quais sites uma chave está sendo usada. Ele também pode liberar uma ativação quando um cliente muda para um novo site.

Essas cinco habilidades aparecem quando o Licenciamento de Software 3.9.8 ou mais recente está ativo.

Consultando Licenças

• Ler Licenças (edd/license-read) consulta uma licença por ID ou chave de licença. Ele também lista licenças filtradas por status, cliente, produto, pedido ou intervalo de datas de expiração. Cada resultado mostra o produto, a data de expiração e quantas ativações estão em uso.
• Ler Ativações de Licença (edd/license-activation-read) mostra em quantos sites uma licença está ativada, qual é o limite e se há ativações restantes. A lista de sites é incluída apenas para contas autorizadas a visualizar dados confidenciais da loja. Essa lista também mostra quais sites são instalações de desenvolvimento local.

As chaves de licença funcionam como senhas, portanto, seu assistente vê apenas os últimos quatro caracteres. A chave completa é mostrada apenas para contas autorizadas a visualizar dados confidenciais da loja.

Alterando Licenças

Esses três só são executados quando Permitir que a IA altere os dados da loja está ativado.

• Desativar Site de Licença (edd/license-site-deactivate) remove um site de uma licença e libera uma ativação. É o que deve ser usado quando um cliente mudou de hospedagem ou parou de usar seu produto em um site. O cliente pode ativar esse site novamente com sua chave. Este é marcado como destrutivo.
• Atualizar Limite de Ativação de Licença (edd/license-activation-limit-update) altera em quantos sites uma licença pode ser ativada ou a redefine para o padrão do produto. Um limite de zero significa ilimitado.
• Atualizar Status da Licença (edd/license-status-update) ativa ou desativa uma licença. Desativar uma licença impede que a chave funcione em todos os sites. Ativar uma licença expirada a deixa expirada, então o cliente ainda precisa renová-la.

Cada alteração de licença também adiciona uma entrada ao log dessa licença, nomeando a habilidade e a conta que ela representou.

Quando o "Software Licensing" está ativo, um cartão de Licenças também aparece na aba "IA", listando o que seu assistente pode fazer com licenças.

O "Recurring Payments" adiciona um conjunto semelhante de funcionalidades para assinaturas.

Habilidades de Pagamentos Recorrentes

Se você vende assinaturas com Recurring Payments, seu assistente pode responder perguntas de faturamento sem que você precise abrir cada assinatura. Ele pode encontrar a assinatura de um cliente, verificar quando ela será renovada e ver o que já foi faturado.

Essas quatro funcionalidades aparecem quando o "Recurring Payments" 2.14.0 ou mais recente está ativo.

Consultando Assinaturas

• Ler Assinaturas (edd/subscription-read) busca uma assinatura por ID. Ele também lista assinaturas filtradas por status, cliente, produto, opção de preço, gateway de pagamento ou intervalo de datas de expiração. Endereços de e-mail de clientes e IDs de gateway de pagamento são incluídos apenas para contas autorizadas a visualizar dados confidenciais da loja.
• Ler Renovações de Assinatura (edd/subscription-renewal-read) lista os pagamentos de renovação de uma assinatura e o que foi faturado até o momento.
• Ler Notas de Assinatura (edd/subscription-note-read) lista as notas registradas em uma assinatura.

Alterando Assinaturas

Assim como as outras funcionalidades de escrita, esta só é executada quando Permitir que a IA altere dados da loja está ativado.

• Adicionar Nota de Assinatura (edd/subscription-note-add) adiciona uma nota interna a uma assinatura.

Observação: Cancelar uma assinatura ou alterar seu faturamento permanece na tela de assinatura em seu admin, que é onde você mesmo lida com isso.

Quando o "Recurring Payments" está ativo, um cartão de Assinaturas também aparece na aba "IA", listando o que seu assistente pode fazer com assinaturas.

Cada funcionalidade nesta página, incluindo as de destaque, também depende da conta com a qual seu assistente se conecta.

Como as Permissões Decidem o Que Executa

Ativar o acesso de escrita não concede a um assistente mais poder do que a conta com a qual ele se conectou. Cada funcionalidade verifica essa conta em comparação com a mesma permissão que a tela de admin correspondente usa. Um assistente conectado como um contador da loja pode ler seus pedidos e relatórios de vendas. Ele não pode criar um código de desconto ou ler as configurações da sua loja, porque essa função não carrega essas permissões.

A permissão que cada grupo precisa se alinha com o painel de uma forma fácil de prever:

• Funcionalidades de Pedidos e Clientes exigem permissão para editar pagamentos, que é o que as telas de Pedidos e Clientes exigem. Ler clientes e notas de clientes exige permissão de visualização de relatórios em vez disso.
• Funcionalidades de Produtos exigem permissão para editar produtos, e a criação de um exige permissão para publicá-los.
• Funcionalidades de Descontos exigem permissão para gerenciar descontos.
• Funcionalidades de Relatórios exigem permissão para visualizar relatórios da loja.
• Funcionalidades de Configurações, taxas de imposto, verificação de integridade e logs exigem permissão para gerenciar as configurações da loja.
• Funcionalidades de Licenças exigem permissão para visualizar licenças, e as três alterações de licença exigem permissão para gerenciar licenças. Isso corresponde ao que a tela de Licenças exige.
• Habilidades de assinatura precisam de permissão para visualizar assinaturas, o que também inclui adicionar uma nota de assinatura.

Escolher a conta que você conecta é, portanto, a principal maneira de limitar o que um assistente pode alcançar. Isso se aplica tanto a leituras quanto a alterações.

Se você deseja que um assistente alcance tudo nesta página, conecte uma conta com a função de gerente da loja, que carrega todas as permissões acima. Para uma conexão mais restrita, a função de contador da loja abrange pedidos, clientes e relatórios de vendas, deixando descontos, configurações da loja e logs fora de alcance. Ela também retém os endereços de e-mail e endereços de correspondência dos clientes, pois essa função não pode visualizar dados confidenciais da loja.

A mesma divisão se aplica às habilidades de recursos. Um contador da loja pode ler assinaturas, mas não pode ver ou alterar licenças. Gerentes da loja e funcionários da loja podem fazer ambos.

Veja o Guia para Iniciantes sobre Funções e Permissões de Usuário do WordPress para saber como definir o que uma conta pode fazer. para limitar o que um assistente pode alcançar, e isso se aplica tanto a leituras quanto a alterações.

Verificando o Que Sua Própria Loja Expõe

Em vez de trabalhar nesta página, você pode ler a lista ao vivo em sua própria loja. Na barra lateral de administração do WordPress, vá para Downloads » Ferramentas, e então selecione a aba IA.

A aba IA abre em um painel que lista os assistentes que sua loja suporta.

WPVibe, o plugin conector gratuito, é instalado a partir desse mesmo painel ao lado do seletor de acesso de gravação, e Conectando Sua Loja a um Assistente de IA cobre ambos.

Mais abaixo nessa aba, os cards agrupam tudo o que sua loja descreve atualmente.

A frase ao lado do título conta para você. Ela fornece o número de coisas que um assistente pode procurar e o número de alterações que ele pode fazer assim que você as permitir.

Como essas contagens são geradas a partir do que está registrado, elas são a resposta confiável para sua loja e se movem sozinhas conforme você ativa ou desativa recursos.

É isso! Você sabe o que cada habilidade faz, quais alteram dados e como ler a lista em tempo real da sua própria loja. Em seguida, veja O que um Assistente de IA Conectado Pode Ver e Alterar para os dados por trás dessas habilidades, ou Solução de Problemas da Conexão de IA da Sua Loja se uma habilidade estiver faltando na lista do seu assistente.

Perguntas Frequentes

Abaixo, respondemos a algumas das perguntas mais comuns sobre as habilidades da loja.