Documentação
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.
No Slack, você lê o AutoPSEO; não o opera por lá. Relatórios agendados e alertas chegam como mensagens formatadas com um botão Open report que leva de volta ao app, e qualquer página de relatório pode enviar a tabela que você está vendo para um canal com Send to Slack. As regras são criadas, pausadas e silenciadas no AutoPSEO, porque um webhook de entrada só transporta mensagens em um sentido.
Como é uma mensagem
As mensagens usam o layout Block Kit do Slack. De cima para baixo:
- Cabeçalho: o tipo de relatório ou o detector e a propriedade, sem o prefixo
sc-domain:. O cabeçalho de um alerta começa com um marcador de severidade. - Resumo: uma frase com o período e a principal variação.
- Campos: até dez valores com rótulo. Um relatório mostra cliques, impressões, CTR e posição média com a respectiva variação; um alerta mostra a métrica, o valor atual, a linha de base, o período e a variação.
- Tabela: até dez linhas em um bloco de largura fixa, em relatórios e resumos de relatórios.
- Rodapé: a propriedade, a severidade (nos alertas) e o horário de envio da mensagem em UTC.
- Open report: um botão para o relatório correspondente no AutoPSEO.
Os valores de uma mensagem são um instantâneo. O relatório por trás do botão abre com o intervalo de datas habitual, portanto seus totais podem diferir do período da mensagem.
Enviar qualquer relatório para o Slack
A maioria das páginas de relatório tem um botão Send to Slack, um ícone de avião de papel na barra de ferramentas. Apesar do nome, ele publica em qualquer canal que você tenha adicionado, inclusive Microsoft Teams e webhooks.
- Espere a tabela da página terminar de carregar. Se clicar antes, você só verá um lembrete para aguardar.
- Clique em Send to Slack. A caixa de diálogo lista seus canais; se você ainda não tiver nenhum, ela oferece Set up a channel.
- Escolha o canal e, se quiser, adicione uma observação de até 300 caracteres, por exemplo o que você gostaria que a equipe analisasse.
- Confira a prévia das primeiras linhas e clique em Send now.
A mensagem inclui o título da página e a propriedade, o intervalo de datas exibido na página, até oito dos cartões de resumo da página, além das dez primeiras linhas e das seis primeiras colunas visíveis da tabela principal, ordenadas e filtradas como você as deixou. O link Open report reabre a página com os mesmos filtros e datas. Um webhook a recebe com o tipo de evento report_summary.
Ver o que cada canal do Slack recebe
Em Slack, Teams & Webhooks, a tabela Slack - Subscriptions lista todos os canais do Slack que você adicionou, com cada relatório agendado e alerta que publica neles, sua programação e se estão ativos ou pausados. Um canal sem nada associado exibe Nothing posts here yet, o que facilita identificar e excluir entradas sem uso.
O que acontece no Slack e o que não acontece
- Respostas, reações e threads ficam no Slack. O AutoPSEO não lê o canal.
- Excluir uma mensagem no Slack não altera nada no AutoPSEO, e a próxima mensagem agendada continua chegando.
- Não há comando de barra nem botão para confirmar ou silenciar um alerta. Para reduzir o ruído de uma regra, defina Mute until nela ou pause-a (Alerts).
- Para que um canal deixe de receber qualquer coisa, pause as regras dele ou exclua a entrada do canal (Connecting Slack).
- Para mudar o conteúdo de um relatório, edite a programação no app (Scheduled reports).
Compartilhar além do canal
Uma mensagem no Slack serve para quem já está no canal. Para um cliente ou colega sem login, um share link oferece um instantâneo de um relatório, e uma export entrega a tabela como arquivo para você repassar.