Documentação
Slack, Teams e webhooks
Envie relatórios agendados e alertas do Search Console para Slack, Microsoft Teams ou qualquer endpoint HTTPS, tudo gerenciado em uma única página com um registro de entregas.
O AutoPSEO leva seus números para fora do app de duas formas: relatórios agendados com os principais indicadores do Search Console de uma propriedade e alertas disparados quando um detector percebe mudanças em cliques, CTR, posições, indexação, rankings monitorados ou auditorias. Ambos seguem para um canal que você adiciona uma única vez: um webhook de entrada do Slack, uma URL do Workflows do Microsoft Teams ou qualquer endpoint HTTPS público que aceite JSON assinado. Você gerencia tudo em uma única página.
Onde encontrar
Abra Slack, Teams & Webhooks na barra lateral esquerda ou acesse Account e escolha Manage no card Slack, Teams & webhooks (abrir no app). A página tem uma seção para cada destino (Slack - Connected workspaces, Microsoft Teams, Outbound webhooks), seguidas de Scheduled reports, Alerts e Delivery history.
Canais, regras e entregas
O recurso se baseia em três elementos.
- Canal: uma URL de destino, identificada como Slack, Microsoft Teams ou Webhook. O AutoPSEO armazena a URL criptografada e, depois disso, exibe apenas o host e os últimos caracteres. Uma conta pode ter 25 canais.
- Regra: um relatório agendado ou um alerta, apontado para exatamente um canal. Um canal pode alimentar qualquer número de regras, até 50 regras por conta. Para receber o mesmo alerta no Slack e no Teams, crie duas regras.
- Entrega: uma tentativa de publicar uma mensagem. O Delivery history guarda as últimas 50 tentativas de todos os canais, incluindo testes e resumos avulsos, com o status (enviada, com falha ou ignorada), o status HTTP, o tempo que o destino levou para responder e o motivo informado em caso de falha.
Canais e regras pertencem ao seu próprio login. Um colega que queira receber alertas no próprio canal precisa configurar os dele.
Do zero à primeira mensagem
- Conecte as propriedades do Search Console que você quer incluir nos relatórios (Connecting Search Console). A propriedade de demonstração aparece em todos os seletores, então você pode testar uma regra antes de seus próprios dados chegarem.
- Adicione um canal com Add to Slack, New Teams channel ou New webhook: dê um nome e cole a URL. Veja onde obter cada URL: Slack, Microsoft Teams, webhooks.
- Clique em Send test na linha do canal e confirme que a mensagem chegou.
- Crie uma regra com New scheduled report ou New alert. Os dois botões ficam desativados até que exista pelo menos um canal.
Quando as mensagens são enviadas
Uma tarefa é executada no início de cada hora (UTC) e determina o que deve ser enviado.
| Mensagem | Quando é enviada |
|---|---|
| Relatório agendado | Na hora que você escolher, diariamente, semanalmente ou mensalmente, no máximo uma vez por período |
| Alerta sobre cliques, CTR, posição, consultas perdidas, monitoramento de ranking ou auditorias | Verificado uma vez por dia, na execução das 06:00 UTC |
| Alerta sobre mudanças de indexação | Verificado a cada hora |
| Send test, Send now, Test rule | Imediatamente |
| Send to Slack em uma página de relatório | Imediatamente (Usando o AutoPSEO no Slack) |
As janelas de relatórios e alertas terminam no dia anterior à execução, porque o Search Console publica seus dados com atraso. Cada mensagem informa as datas usadas, para que ninguém precise adivinhar.
O que você precisa
- Um plano ativo ou um período de teste em andamento. Quando um período de teste termina sem um plano contratado, os relatórios agendados e os alertas são interrompidos, e novos canais, alterações em regras, testes e envios são recusados até que você escolha um plano (planos e cobrança).
- Um destino sob seu controle: permissão para criar um webhook de entrada no Slack, um webhook do Workflows em um canal do Teams ou um endpoint HTTPS próprio.
Atenção a quem pode ler o canal
Toda mensagem contém dados de desempenho de busca: cliques, impressões, consultas e endereços de páginas. Qualquer pessoa que tenha acesso de leitura ao canal do Slack ou do Teams, ou ao sistema por trás de um webhook, verá esses dados, por isso publique as propriedades de clientes em canais privados. A URL de destino também é um segredo: quem a possui pode publicar no seu canal, como o Slack alerta sobre seus webhooks. Por isso o AutoPSEO nunca a exibe novamente depois que você a salva.
Leia a seguir
- Conectando o Slack com um webhook de entrada: como criar a URL no Slack, adicioná-la e os erros que o Slack pode retornar.
- Relatórios agendados: tipos de relatório, períodos, frequência e a regra de uma vez por período.
- Alertas: os nove detectores, limites, severidade e silenciamento.
- Usando o AutoPSEO no Slack: o que uma mensagem contém e como funciona o Send to Slack.
- Microsoft Teams: URLs do Workflows e Adaptive Cards.
- Webhooks de saída: o corpo JSON, os tipos de evento e a verificação da assinatura.
Visões gerais do produto: AutoPSEO para Slack e AutoPSEO para Microsoft Teams.
Nesta seção
Conectar o Slack com um webhook de entrada
Crie um webhook de entrada do Slack para um canal, adicione-o ao AutoPSEO, envie uma mensagem de teste e corrija os erros que o Slack retorna quando uma publicação falha.
Relatórios agendados no Slack, no Teams ou em um webhook
Publique em um canal, diariamente, semanalmente ou mensalmente, os cliques, as impressões, o CTR e a posição de uma propriedade, junto com as principais consultas, páginas ou variações de ranking.
Alertas: detectores, limites e severidade
Nove detectores monitoram cliques, CTR, posição, consultas perdidas, mudanças de indexação, rankings e auditorias, e só publicam em um canal quando um limite é ultrapassado.
Usar o AutoPSEO no Slack
O que as mensagens do AutoPSEO no Slack contêm, como o Send to Slack publica qualquer tabela de relatório em um canal e o que você pode ou não fazer diretamente no Slack.
Alertas e relatórios no Microsoft Teams
Crie um webhook do Workflows em um canal do Teams, adicione-o ao AutoPSEO e receba alertas e relatórios agendados como Adaptive Cards coloridos conforme a gravidade.
Webhooks de saída: payload e assinatura
Receba alertas e relatórios do AutoPSEO como JSON assinado em qualquer endpoint HTTPS: os cabeçalhos da requisição, os campos do corpo, os tipos de evento e como verificar a assinatura.