Proof Docs

Slack

Mention Proof with a customer task. It checks the task in a clean browser and returns the result and video evidence in the same Slack thread.

Ask Proof to check something

Mention the bot in a channel where it is installed. After the first mention, follow-up messages in that thread can start more Jobs.

text
@Proof complete checkout with a declined card and confirm the order is not created

Write a good task

Name the customer goal, important condition, and visible outcome. Prefer “invite a viewer and confirm they cannot change billing” to “test permissions.” You do not need to list clicks or selectors. Proof chooses steps from the page it sees.

  • Include the edge case or account state.
  • State the business outcome that must or must not happen.
  • Avoid real customer credentials or secrets in the message.

What Proof posts back

Proof first posts a Job link. When the Job ends, it posts the final status, a Finding summary when needed, and links to video evidence when available.

Administrator setup

The Slack app needs SLACK_BOT_TOKEN and SLACK_SIGNING_SECRET. This initial implementation maps Slack to one default organization, repository, and browser URL through PROOF_DEFAULT_ORGANIZATION_ID, PROOF_DEFAULT_REPOSITORY_ID, and PROOF_DEFAULT_BASE_URL.

Set the Slack event URL to https://your-proof-host/api/webhooks/slack and subscribe the app to mention events. The adapter verifies Slack signatures before processing a message.