Você sabia que o Amplify Engage sempre ofereceu suporte a notificações de eventos baseadas em webhooks? Permitindo, assim, que administradores da plataforma respondessem a eventos como:
- Descoberta de novas APIs
- Mudanças de estado no ciclo de vida da API
- Solicitações de assinatura de produtos de API
Esses eventos normalmente são enviados para sistemas externos como ServiceNow, Jira ou plataformas de mensagens, onde podem ser registrados e processados. No entanto, configurar listeners de webhook nesses destinos nem sempre é viável.
Para resolver isso, o Amplify Engage introduz os watch topics — um padrão alternativo e poderoso para notificações que simplifica o manuseio de eventos e amplia a flexibilidade de integração.
O que são watch topics?
Watch topics permitem que o Engage registre eventos em um tópico que pode ser consultado por:
- Aplicativos de destino
- Camadas de orquestração, como o Amplify Fusion
Isso habilita o processamento assíncrono de eventos, sem a necessidade de entrega direta via webhook. Os watch topics são gerenciados inteiramente dentro do Engage, exigindo apenas uma definição de tópico e filtros de evento associados.
Caso de uso 1: notificar quando uma nova assinatura de produto de API é criada
Especialmente últil quando o processo de aprovação está definido como manual. Os proprietários de produtos de API podem ser alertados por e-mail ou via sistemas como ServiceNow.
Configuração do watch topic (todos os ambientes):
{
“group”: “management”,
“apiVersion”: “v1alpha1”,
“kind”: “WatchTopic”,
“name”: “subscription-manual-approval”,
“title”: “Subscription Approvals”,
“attributes”: {},
“tags”: [],
“spec”: {
“filters”: [
{
“kind”: “Subscription”,
“name”: “*”,
“type”: [“created”],
“group”: “catalog”
}
],
“description”: “Watch for all create Subscription Requests”
}
}
Limitar a um ambiente específico:
{
“group”: “management”,
“apiVersion”: “v1alpha1”,
“kind”: “WatchTopic”,
“name”: “subscription-manual-approval”,
“title”: “Subscription Approvals”,
“attributes”: {},
“tags”: [],
“spec”: {
“filters”: [
{
“kind”: “Subscription”,
“name”: “*”,
“type”: [“created”],
“group”: “catalog”,
“scope”: {
“kind”: “Environment”,
“name”: “my-env”
}
}
],
“description”: “Watch for all create Subscription Requests”
}
}
Caso de uso 2: notificar quando uma nova versão de API é criada
Quando uma nova versão de API é descoberta, um novo APIServiceRevision é criado. Esse watch topic acompanha esse evento:
{
“group”: “management”,
“apiVersion”: “v1alpha1”,
“kind”: “WatchTopic”,
“name”: “my-env-new-api-version”,
“title”: “Watch for new API versions in the my-env Environment”,
“attributes”: {},
“tags”: [],
“spec”: {
“filters”: [
{
“kind”: “APIServiceRevision”,
“name”: “*”,
“type”: [“created”],
“group”: “management”,
“scope”: {
“kind”: “Environment”,
“name”: “my-env”
}
}
],
“description”: “Watch for new API versions in the my-env Environment”
}
}
Implantando o watch topic com a CLI
axway auth login
axway central apply -f {arquivo.yaml}
Consulte a coleção Postman anexada para exemplos de autenticação, criação, visualização e gerenciamento de watch topics.
Consultando o watch topic via API
Um valor comum para sort é sequenceID, que organiza os resultados em ordem sequencial.
Esse exemplo retorna apenas eventos com sequenceID maior que o informado — ideal para processar apenas novos eventos.
Por que isso importa?
Os watch topics oferecem uma forma flexível, escalável e desacoplada de monitorar e responder a eventos na plataforma. Eles reduzem a dependência de webhooks e integram-se facilmente com ferramentas como o Amplify Fusion.
Pronto para aprimorar seus fluxos orientados a eventos?
Comece hoje a usar os watch topics para fortalecer sua governança de APIs, automatizar aprovações e melhorar a eficiência operacional no seu ecossistema digital.
por Vincent Belfoure
Arquiteto Sênior de Soluções
