Connect GitHub

A step-by-step guide with pictures, from the Speakvora agent's own Connect tab.

Short answer: GOAL: your agent hears about builds, pull requests, releases and security alerts, and tells your team. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to GitHub as the owner or an admin.

Every key, number and name in the pictures is a made-up example. Nothing here asks you to share a real key with anyone but the app on your own computer.

GOAL: your agent hears about builds, pull requests, releases and security alerts, and tells your team. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to GitHub as the owner or an admin.

TIP: You can't break anything. A webhook is only a message GitHub sends. You can delete it and start again.

Part 1. Open the Connect tab in your agent

  1. Open your agent's dashboard (the page you open from the Start Speakvora Agent file).
  2. Press Connect in the menu. On a phone the menu is the bar along the top; slide it sideways if you do not see Connect.
  3. Press Connect (1)

  4. Under Your apps type github in the box that says Find an app (1), or scroll down the list, and press it. A card slides up.
  5. The Find an app box (1)

  6. The card shows an address (it ends in /event) and a secret. Press Copy next to each. Keep the page open.

Part 2. Add it in GitHub

  1. Open your repository on GitHub, then [[Settings > Webhooks > Add webhook]].
  2. Payload URL: paste the agent's address.
  3. Content type: choose application/json.
  4. Secret: paste the secret from the agent card.
  5. Choose Let me select individual events and tick Workflow runs, Pull requests, Releases, Issues, Code scanning alerts and Dependabot alerts.
  6. Press Add webhook.

WARNING: The secret is private. It proves to your agent that a message really came from GitHub.

Part 3. Test it

  1. Press Save and test on the card (paste the secret first if the card asks you to).

YOU SHOULD SEE: green words saying Connected. After GitHub's first delivery it shows a green tick. A failed workflow run then appears in Activity as *a build failed*.

If something is wrong

  • GitHub shows a red cross on the delivery: open the webhook, press Recent Deliveries and read the response. 401 means the secret differs: paste it again in both places.
  • Nothing in Activity: the address must start with https and end in /event.

All help guides · Every agent feature · AI receptionist by industry

Questions

What if this happens: GitHub shows a red cross on the delivery?

open the webhook, press Recent Deliveries and read the response. 401 means the secret differs: paste it again in both places.

What if this happens: Nothing in Activity?

the address must start with https and end in /event.