Aviso: Não existe documentação legada disponível para este item, pelo que está a ver a documentação atual.
O PushEngage regista um conjunto de Capacidades do WordPress para que assistentes de IA e clientes MCP possam operar as suas notificações push diretamente do seu site WordPress. Cada capacidade é uma ação única e bem descrita, como enviar uma notificação, listar segmentos ou obter um relatório de análise, que um assistente pode descobrir e chamar com a sua permissão. Este guia explica quais são as capacidades, o que é necessário para as utilizar e tudo o que um agente pode fazer.
Antes de Começar
- Precisa da versão 4.2.3 ou posterior do plugin PushEngage. Esta versão regista as capacidades do PushEngage contra a API de Capacidades do WordPress.
- O seu site precisa do WordPress 7.0 ou posterior. A API de Capacidades faz parte do núcleo do WordPress a partir da versão 7.0.
- Tem de ser um administrador. Cada capacidade do PushEngage requer a capacidade
manage_options, e o assistente autentica-se como um utilizador do WordPress através de uma palavra-passe de aplicação. - Para expor as capacidades a um cliente de IA externo através de MCP, adicione o plugin gratuito WP MCP Adapter. Pode ver o seu estado e o resto do seu kit de ferramentas de IA na página Ferramentas do PushEngage em PushEngage » Ferramentas.
- Algumas capacidades só estão disponíveis quando o WooCommerce está ativo.
Como Funcionam as Capacidades do PushEngage
Quando o seu site carrega, o plugin PushEngage regista uma categoria de capacidade pushengage e as suas capacidades através da API de Capacidades do WordPress. Cada capacidade declara uma única capacidade que um assistente de IA pode descobrir e chamar, num 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. Cada capacidade requer a capacidade
manage_options, declarada através dopermission_callbackda API de Capacidades. O assistente é autenticado contra um utilizador do WordPress com uma palavra-passe de aplicação, o mecanismo padrão do WordPress desde a versão 5.6. Um assistente conectado como administrador pode executar as capacidades. Um conectado como colaborador não pode. - Confirmação. Apenas uma capacidade é marcada como destrutiva, Enviar Notificação, pelo que um assistente ciente de MCP confirma consigo antes de enviar. As atualizações de configurações e a criação de segmentos não são destrutivas.
- Privilégio mínimo. Obter Registo de Depuração retorna conteúdo de nível de administrador, como URLs e payloads de solicitação, e está restrito à mesma permissão de administrador que todo o resto. O assistente tem o mesmo acesso que o administrador humano que o executa, e nada mais.
Para aceder às capacidades de um assistente externo, instale o Adaptador WP MCP gratuito, que liga as capacidades registadas ao protocolo MCP que o seu assistente utiliza. Até que um adaptador ou cliente MCP esteja ligado, as capacidades são registadas, mas nenhum agente as pode aceder ainda.
O que um Agente Pode Fazer
O PushEngage regista 22 capacidades, agrupadas abaixo pelo trabalho que realizam. O número exato apresentado na sua página de Ferramentas pode diferir com base no que está ativo no seu site, uma vez que algumas capacidades só se registam quando o WooCommerce está presente. "Tipo" indica se uma capacidade apenas lê dados ou também escreve alterações.
Enviar notificações push
| Capacidade | O que faz | Tipo |
|---|---|---|
| Enviar Notificação | Envia uma notificação push para os subscritores. | Escrever |
| Obter Notificação | Retorna detalhes de uma única notificação. | Apenas leitura |
| Listar Notificações | Lista notificações, com filtro de estado opcional e paginação. | Apenas leitura |
| Obter Estado da Ligação | Retorna se o site está ligado a uma conta PushEngage. | Apenas leitura |
Construir e segmentar públicos
| Capacidade | O que faz | Tipo |
|---|---|---|
| Listar Segmentos | Lista segmentos de subscritores. | 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 subscritores. | Escrever |
| Adicionar Subscritores ao Segmento | Adiciona subscritores a um segmento existente. | Escrever |
Ler as suas análises
| Capacidade | 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 subscritores, impressões e cliques num intervalo de datas, agrupados por dia, semana ou mês. | Apenas leitura |
| Obter Análises de Subscritores | Retorna assinantes ativos semanais e totais. | Apenas leitura |
Configurar push automático
| Capacidade | O que faz | Tipo |
|---|---|---|
| Obter Configurações de Push Automático | Retorna a configuração de push automático, incluindo tipos de post ativados e sinalizadores de funcionalidades. | Apenas leitura |
| Atualizar Configurações de Push Automático | Atualiza o push automático, incluindo o interruptor, tipos de post, ícone e sinalizadores de funcionalidades. | Escrever |
| Listar Categorias | Lista as categorias de posts do WordPress, mais as categorias de produtos do WooCommerce quando o WooCommerce está ativo. | Apenas leitura |
| Listar Mapeamentos de Segmentos de Categoria | Lista o mapeamento das categorias do WordPress para segmentos do PushEngage. | Apenas leitura |
| Obter Mapeamentos de Atributos | Retorna o mapeamento dos atributos de assinantes do PushEngage para chaves de meta de utilizador do WordPress. | Apenas leitura |
Executar automações WooCommerce e WhatsApp
Estas capacidades estão disponíveis apenas quando o WooCommerce está ativo. Obter Estado do WhatsApp também requer credenciais válidas do WhatsApp.
| Capacidade | 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 Estado do WhatsApp | Retorna se as credenciais de integração do WhatsApp são válidas. | Apenas leitura |
Diagnosticar e verificar
| Capacidade | O que faz | Tipo |
|---|---|---|
| Obter Informações do Plugin | Retorna a versão do plugin, o estado da ligaçã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 Registo de Depuração | Lista ficheiros de registo de depuração e lê um ficheiro específico quando é fornecido um nome de ficheiro. Apenas para administradores, pois o conteúdo do registo pode incluir URLs e payloads de pedido. | Apenas leitura |
O Que Pode Perguntar ao Seu Assistente
Quando um cliente MCP estiver ligado, descreva o trabalho em linguagem simples e o assistente chamará as capacidades corretas. Por exemplo:
- “Encontre o meu segmento de compradores interessados, depois envie a todos nele uma notificação push com o título ‘A promoção relâmpago termina à meia-noite’ com ligação para a minha página de vendas.” O assistente lista os segmentos para encontrar o ID, depois envia a notificação, confirmando antes de a disparar.
- “Mostre-me um relatório de análise semana a semana dos últimos 30 dias, e quais campanhas geraram mais cliques.” O assistente recupera a visão geral da análise e mapeia os envios para os títulos.
- “Desative a 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 /preços nos últimos sete dias.” O assistente cria o segmento a partir da sua descrição.
Perguntas Frequentes
Quem pode usar estas capacidades?
Apenas administradores. Todas as capacidades do PushEngage requerem a capacidade manage_options, e o assistente autentica-se como um utilizador do WordPress através de uma palavra-passe de aplicação. Um assistente ligado como administrador pode executar as capacidades, enquanto um ligado como colaborador não pode.
Preciso do Adaptador MCP?
Precisa dele para aceder às capacidades a partir de um cliente de IA externo através do MCP. As capacidades registam-se na API de Capacidades do WordPress por si só, mas o Adaptador WP MCP gratuito é o que as liga ao protocolo MCP que o seu assistente fala. Pode verificar o seu estado na página de Ferramentas do PushEngage.
Porque é que a minha página de Ferramentas mostra um número diferente de capacidades?
O PushEngage regista 22 capacidades no total, mas a automação de notificações push do WooCommerce e as capacidades do WhatsApp registam-se apenas quando o WooCommerce está ativo, pelo que a contagem mostrada no seu site depende do que está ativo.
Um agente alterará a minha conta sem pedir?
As capacidades de apenas leitura apenas retornam dados. Apenas Enviar Notificação é marcada como destrutiva, pelo que um assistente ciente de MCP confirma consigo antes de disparar um envio. Atualizações de configurações e criação de segmentos não são destrutivas e executam-se sem um pedido.
De que versões de plugin e WordPress preciso?
PushEngage 4.2.3 ou posterior para as capacidades, e WordPress 7.0 ou posterior para a API de Capacidades. Recomenda-se manter o plugin atualizado, pois versões posteriores refinam as capacidades e as suas respostas de IA e MCP.
Se encontrar algum problema, n0o hesite em contactar-nos clicando aqui. A nossa equipa de suporte poder0 ajud0-lo.
