Aviso: Não há documentação legada disponível para este item, portanto, você está vendo a documentação atual.
O PushEngage registra um conjunto de Habilidades do WordPress para que assistentes de IA e clientes MCP possam operar suas notificações push diretamente do seu site WordPress. Cada habilidade é uma ação única e bem descrita, como enviar uma notificação, listar segmentos ou extrair um relatório de análise, que um assistente pode descobrir e chamar com sua permissão. Este guia explica quais são as habilidades, o que é necessário para usá-las e tudo o que um agente pode fazer.
Antes de Começar
- Você precisa da versão 4.2.3 ou posterior do plugin PushEngage. Esta versão registra as habilidades do PushEngage na API de Habilidades do WordPress.
- Seu site precisa do WordPress 7.0 ou posterior. A API de Habilidades faz parte do núcleo do WordPress a partir da versão 7.0.
- Você deve ser um administrador. Toda habilidade do PushEngage requer a capacidade
manage_options, e o assistente se autentica como um usuário do WordPress por meio de uma senha de aplicativo. - Para expor as habilidades a um cliente de IA externo via MCP, adicione o plugin gratuito WP MCP Adapter. Você pode ver seu status e o restante do seu kit de ferramentas de IA na página Ferramentas do PushEngage em PushEngage » Ferramentas.
- Algumas habilidades estão disponíveis apenas quando o WooCommerce está ativo.
Como Funcionam as Habilidades do PushEngage
Quando seu site carrega, o plugin PushEngage registra uma categoria de habilidade pushengage e suas habilidades por meio da API de Habilidades do WordPress. Cada habilidade declara uma única capacidade que um assistente de IA pode descobrir e chamar, em um formato legível por máquina e compatível com MCP.
O acesso é herdado do WordPress, não de um sistema separado criado pelo PushEngage:
- Permissão. Toda habilidade requer a capacidade
manage_options, declarada por meio dopermission_callbackda API de Habilidades. O assistente é autenticado contra um usuário do WordPress com uma senha de aplicativo, o mecanismo padrão do WordPress desde a versão 5.6. Um assistente conectado como administrador pode executar as habilidades. Um conectado como colaborador não pode. - Confirmação. Apenas uma habilidade é marcada como destrutiva, Enviar Notificação, então um assistente ciente de MCP confirma com você antes de enviar. Atualizações de configurações e criação de segmentos não são destrutivas.
- Mínimo privilégio. Obter Log de Depuração retorna conteúdo de nível de administrador, como URLs e cargas de solicitação, e está restrito à mesma permissão de administrador de todo o resto. O assistente tem o mesmo acesso que o administrador humano que o executa, e nada mais.
Para alcançar as habilidades de um assistente externo, instale o Adaptador WP MCP gratuito, que conecta as habilidades registradas ao protocolo MCP que seu assistente fala. Até que um adaptador ou cliente MCP seja conectado, as habilidades são registradas, mas nenhum agente pode acessá-las ainda.
O Que um Agente Pode Fazer
O PushEngage registra 22 habilidades, agrupadas abaixo pelo trabalho que realizam. O número exato exibido em sua página de Ferramentas pode diferir com base no que está ativo em seu site, pois algumas habilidades se registram apenas quando o WooCommerce está presente. "Tipo" mostra se uma habilidade apenas lê dados ou também grava alterações.
Enviar notificações push
| Habilidade | O que faz | Tipo |
|---|---|---|
| Enviar Notificação | Envia uma notificação push para os assinantes. | Escrever |
| Obter Notificação | Retorna detalhes de uma única notificação. | Apenas leitura |
| Listar Notificações | Lista notificações, com filtro de status opcional e paginação. | Apenas leitura |
| Obter Status da Conexão | Retorna se o site está conectado a uma conta PushEngage. | Apenas leitura |
Criar e segmentar públicos
| Habilidade | O que faz | Tipo |
|---|---|---|
| Listar Segmentos | Lista segmentos de assinantes. | Apenas leitura |
| Listar Grupos de Público | Lista grupos de público disponíveis para segmentação. | Apenas leitura |
| Criar Segmento | Cria um novo segmento de assinantes. | Escrever |
| Adicionar Assinantes ao Segmento | Adiciona assinantes a um segmento existente. | Escrever |
Ler suas análises
| Habilidade | O que faz | Tipo |
|---|---|---|
| Obter Resumo de Notificações | Retorna contagens agregadas de envios, visualizações e cliques em todas as notificações. | Apenas leitura |
| Obter Visão Geral das Análises | Retorna assinantes, impressões e cliques em um intervalo de datas, agrupados por dia, semana ou mês. | Apenas leitura |
| Obter Análises de Assinantes | Retorna assinantes ativos semanais e totais. | Apenas leitura |
Configurar push automático
| Habilidade | O que faz | Tipo |
|---|---|---|
| Obter Configurações de Push Automático | Retorna a configuração de push automático, incluindo tipos de postagem ativados e sinalizadores de recursos. | Apenas leitura |
| Atualizar Configurações de Push Automático | Atualiza o push automático, incluindo o alternador, tipos de postagem, ícone e sinalizadores de recursos. | Escrever |
| Listar Categorias | Lista as categorias de postagem do WordPress, além das categorias de produtos do WooCommerce quando o WooCommerce está ativo. | Apenas leitura |
| Listar Mapeamentos de Segmentos de Categoria | Lista o mapeamento de categorias do WordPress para segmentos do PushEngage. | Apenas leitura |
| Obter Mapeamentos de Atributos | Retorna o mapeamento de atributos de assinantes do PushEngage para chaves de metadados de usuários do WordPress. | Apenas leitura |
Executar automações do WooCommerce e WhatsApp
Essas funcionalidades estão disponíveis apenas quando o WooCommerce está ativo. Obter Status do WhatsApp também requer credenciais válidas do WhatsApp.
| Habilidade | O que faz | Tipo |
|---|---|---|
| Listar Campanhas de Automação de Push | Lista campanhas de automação de push do WooCommerce com configurações de administrador e cliente. | Apenas leitura |
| Atualizar Campanha de Automação de Push | Ativa, desativa ou configura uma campanha de automação de push do WooCommerce. | Escrever |
| Listar Campanhas de Automação do WhatsApp | Lista campanhas de automação do WhatsApp configuradas para eventos do WooCommerce. | Apenas leitura |
| Obter Status do WhatsApp | Retorna se as credenciais de integração do WhatsApp são válidas. | Apenas leitura |
Diagnosticar e verificar
| Habilidade | O que faz | Tipo |
|---|---|---|
| Obter Informações do Plugin | Retorna a versão do plugin, o estado da conexão e a configuração principal. | Apenas leitura |
| Obter Ambiente do Site | Retorna detalhes do WordPress, PHP e do servidor para diagnósticos. | Apenas leitura |
| Obter Log de Depuração | Lista arquivos de log de depuração e lê um arquivo específico quando um nome de arquivo é fornecido. Apenas para administradores, pois o conteúdo do log pode incluir URLs e cargas úteis de solicitação. | Apenas leitura |
O que você pode perguntar ao seu assistente
Uma vez que um cliente MCP esteja conectado, você descreve o trabalho em linguagem simples e o assistente chama as habilidades certas. Por exemplo:
- “Encontre meu segmento de compradores engajados e, em seguida, envie a todos nele uma notificação push com o título ‘Promoção relâmpago termina à meia-noite’ vinculando à minha página de vendas.” O assistente lista os segmentos para encontrar o ID e, em seguida, envia a notificação, confirmando antes de dispará-la.
- “Mostre-me um relatório de análise semana a semana dos últimos 30 dias e quais campanhas geraram mais cliques.” O assistente extrai a visão geral da análise e mapeia os envios para os títulos.
- “Desative minha campanha de abandono de navegação do WooCommerce até terça-feira.” O assistente lista as campanhas de automação e atualiza a correta.
- “Crie um segmento chamado visitantes-da-página-de-preços que capture qualquer pessoa que visitou /pricing nos últimos sete dias.” O assistente cria o segmento a partir da sua descrição.
Perguntas Frequentes
Quem pode usar essas habilidades?
Apenas administradores. Toda habilidade do PushEngage requer a capacidade manage_options, e o assistente se autentica como um usuário do WordPress através de uma senha de aplicativo. Um assistente conectado como administrador pode executar as habilidades, enquanto um conectado como colaborador não pode.
Preciso do Adaptador MCP?
Você precisa dele para acessar as habilidades de um cliente de IA externo via MCP. As habilidades se registram na API de Habilidades do WordPress por conta própria, mas o Adaptador WP MCP gratuito é o que as conecta ao protocolo MCP que seu assistente fala. Você pode verificar seu status na página Ferramentas do PushEngage.
Por que minha página de Ferramentas mostra um número diferente de habilidades?
O PushEngage registra 22 habilidades no total, mas a automação de push do WooCommerce e as habilidades do WhatsApp se registram apenas quando o WooCommerce está ativo, então a contagem mostrada em seu site depende do que está ativo.
Um agente mudará minha conta sem perguntar?
As habilidades somente leitura apenas retornam dados. Apenas Enviar Notificação é marcada como destrutiva, então um assistente ciente de MCP confirma com você antes de disparar um envio. Atualizações de configurações e criação de segmentos não são destrutivas e são executadas sem um prompt.
Quais versões de plugin e WordPress eu preciso?
PushEngage 4.2.3 ou posterior para as habilidades, e WordPress 7.0 ou posterior para a API de Habilidades. Manter o plugin atualizado é recomendado, pois versões posteriores refinam as habilidades e suas respostas de IA e MCP.
Se você encontrar algum problema, sinta-se à vontade para entrar em contato conosco clicando aqui. Nossa equipe de suporte poderá ajudá-lo.
