Por que o Slack precisa que o desafio seja retornado?

Isso prova que a URL é controlada por alguém que pode ler o corpo da solicitação, em vez de um endereço arbitrário que alguém digitou. Até que o eco seja bem-sucedido, o Slack se recusa a enviar quaisquer eventos para o endpoint.

Ele verifica a assinatura do Slack?

Não. O cabeçalho X-Slack-Signature não é verificado, então o mock retorna o desafio a qualquer um que poste um corpo correspondente. A verificação de assinatura pertence ao seu manipulador real e deve ser testada contra o próprio Slack.

Ele manipulará eventos reais após a verificação?

Ele os aceitará e retornará a mesma forma de eco, o que não é o que um manipulador de eventos deveria responder. Use este modelo para passar pela verificação e, em seguida, aponte o Slack para seu próprio endpoint.

Simular o desafio da API de Eventos do Slack

Um mock POST que responde ao handshake de url_verification do Slack enviando de volta o valor do desafio.

O Slack não ativará um endpoint da API de Eventos até que ele responda ao handshake url_verification ecoando de volta o valor do desafio que foi enviado. Este modelo faz exatamente isso: ele lê o desafio da solicitação recebida e o retorna, para que você possa ter um endpoint verificado antes que seu manipulador real exista. A resposta é um campo único porque é precisamente isso que o handshake do Slack exige.

Aceita uma chamada recebida e responde da maneira que o serviço espera.

Payload de resposta

{
  "challenge": "{{request.body.challenge}}"
}

Campos que valem a pena conhecer

Campo	O que significa
challenge	Ecoado diretamente do corpo da sua solicitação via {{request.body.challenge}} — exatamente o que o handshake url_verification do Slack verifica.

Criar o mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "POST",
  "response_status": 200,
  "content_type": "application/json",
  "response_body": "{\"challenge\":\"{{request.body.challenge}}\"}"
}'

Chame-o

curl -X POST -H 'Content-Type: application/json' -d '{"token":"verification-token-8f3a","challenge":"3eZbrw1aBm2rZSFEGRbdazZQb7aoEXsdMY19q6IcvKf","type":"url_verification"}' https://quickmock.dev/m/<slug>

O que você obtém

POST the url_verification payload -> 200 echoes {"challenge":"..."} back
Slack requires this exact echo to verify the Events API endpoint

Como isso difere do original

A assinatura da solicitação (o cabeçalho X-Slack-Signature) não é verificada — este mock envia o mesmo desafio de volta a qualquer um que envie um corpo correspondente, não apenas ao próprio Slack.

Fontes

FAQ

Por que o Slack precisa que o desafio seja retornado?: Isso prova que a URL é controlada por alguém que pode ler o corpo da solicitação, em vez de um endereço arbitrário que alguém digitou. Até que o eco seja bem-sucedido, o Slack se recusa a enviar quaisquer eventos para o endpoint.
Ele verifica a assinatura do Slack?: Não. O cabeçalho X-Slack-Signature não é verificado, então o mock retorna o desafio a qualquer um que poste um corpo correspondente. A verificação de assinatura pertence ao seu manipulador real e deve ser testada contra o próprio Slack.
Ele manipulará eventos reais após a verificação?: Ele os aceitará e retornará a mesma forma de eco, o que não é o que um manipulador de eventos deveria responder. Use este modelo para passar pela verificação e, em seguida, aponte o Slack para seu próprio endpoint.

Pronto para usar?

Abrir no construtor de mocks para ajustar primeiro

Combina bem com este guia: Ecoe os dados da requisição de volta

Modelos relacionados

← Todos os modelos

Última atualização: 2026-10-17