Documentaçã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.
O AutoPSEO publica no Slack por meio de webhooks de entrada. O Slack fornece uma URL que grava em um único canal, você cola essa URL no AutoPSEO e os relatórios e alertas passam a chegar lá. O próprio AutoPSEO não instala nada no seu workspace: ele não consegue ler mensagens, listar seus canais nem publicar em qualquer lugar para onde o webhook não aponte. Adicione uma entrada para cada canal em que você quer receber mensagens.
Criar o webhook no Slack
O Slack emite webhooks de entrada por meio de um app do Slack. Seguindo o guia de webhooks de entrada do Slack:
- Crie um app do Slack para o seu workspace ou abra um que você já use para notificações. Escolha um nome que sua equipe reconheça, como Relatórios de SEO.
- Nas configurações do app, abra Incoming Webhooks e ative Activate Incoming Webhooks.
- Clique em Add New Webhook to Workspace, escolha o canal e aprove. Para um canal privado, você precisa ser membro dele antes.
- Copie a nova URL em Webhook URLs for Your Workspace. Ela começa com
https://hooks.slack.com/services/.
Repita os passos 3 e 4 para cada canal adicional; um único app pode ter vários webhooks. Uma URL criada com os webhooks de integração personalizada mais antigos do Slack também continua funcionando, embora o Slack recomende migrá-los para um app.
O Slack trata a URL como um segredo: qualquer pessoa que a tenha pode publicar no canal. Cole-a no AutoPSEO e não a deixe em tickets, wikis ou capturas de tela.
Adicionar ao AutoPSEO
- Em Slack, Teams & Webhooks, localize Slack - Connected workspaces e clique em Add to Slack. O formulário New channel é aberto com o Slack já selecionado como destino.
- Name: um rótulo para as listas do AutoPSEO, o histórico de entregas e a mensagem de teste, por exemplo
#seo-alerts. - Webhook URL: cole a URL do Slack. Para uma entrada do Slack, o AutoPSEO aceita apenas endereços
httpsem slack.com e avisa imediatamente se a URL não for compatível. - Clique em Add channel e, em seguida, em Send test na nova linha. Uma mensagem curta com o nome da entrada deve aparecer no Slack em poucos segundos, e o AutoPSEO informa quanto tempo o Slack levou para responder.
A URL é armazenada criptografada (AES-GCM). A partir daí, a lista mostra apenas o host e os últimos caracteres, portanto escolha nomes que deixem claro qual canal do Slack cada entrada alimenta.
Em seguida, dê a ela algo para publicar: um relatório agendado ou um alerta. A tabela Slack - Subscriptions, abaixo da lista, passa então a mostrar, por canal do Slack, todas as regras que publicam ali, a respectiva programação e se estão ativas ou pausadas.
Vários canais e workspaces
Uma URL de webhook pertence a um canal em um workspace, e o Slack não permite que uma mensagem substitua o canal para o qual o webhook foi criado. Isso mantém tudo previsível:
- Um canal do Slack, uma entrada. Para dividir clientes entre
#client-ae#client-b, crie um webhook para cada um e adicione os dois. - Vários workspaces funcionam da mesma forma, já que cada webhook pertence ao workspace em que você o criou.
- Uma entrada pode ter várias regras. Envie o relatório semanal e o alerta de queda de tráfego para a mesma entrada ou mantenha os alertas em um canal próprio, mais movimentado.
Por que uma mensagem não chegou
Send test mostra o motivo imediatamente. Para mensagens agendadas, abra Delivery history, que guarda a resposta do Slack para cada tentativa com falha.
| O que o AutoPSEO mostra | O que significa | O que fazer |
|---|---|---|
| Slack rejected the URL (no_service) | O webhook foi removido ou desativado no Slack, ou a URL está digitada incorretamente | Crie um novo webhook, adicione-o e depois exclua a entrada antiga |
| The Slack channel no longer exists, or is archived | O Slack respondeu channel_not_found ou channel_is_archived | Crie um webhook para um canal que ainda esteja em uso |
| Slack is rate limiting us | O Slack respondeu HTTP 429 | Aguarde um pouco e use Send now ou Test rule |
| Timed out after 10 seconds | O Slack não respondeu a tempo | Tente novamente mais tarde |
| Your trial has ended | Nenhum plano ou período de teste ativo | Escolha um plano; as entregas agendadas são retomadas com ele |
Um relatório agendado que falhou não é reenviado no mesmo período, portanto use Send now depois de corrigir a causa. Um alerta que não pôde ser publicado é avaliado novamente na próxima verificação (quando os alertas são executados).
Remover um canal do Slack
Delete na linha da entrada remove a URL armazenada e, após uma confirmação que informa quantas são, todas as regras que publicam ali. O AutoPSEO não altera nada no Slack: o webhook continua funcionando até que alguém o remova no app do Slack; portanto, faça isso também se a URL puder ter sido vista por outras pessoas.