Connect GitLab
A step-by-step guide with pictures, from the Speakvora agent's own Connect tab.
Short answer: GOAL: your agent hears about pipelines, merge requests, releases and deployments. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to GitLab 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 pipelines, merge requests, releases and deployments. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to GitLab as the owner or an admin.
TIP: You can't break anything. A webhook is only a message GitLab sends. You can delete it and start again.
Part 1. Open the Connect tab in your agent
- Open your agent's dashboard (the page you open from the Start Speakvora Agent file).
- 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.
- Under Your apps type gitlab in the box that says Find an app (1), or scroll down the list, and press it. A card slides up.
- 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 GitLab
- Open your project on GitLab, then [[Settings > Webhooks > Add new webhook]].
- URL: paste the agent's address.
- Secret token: paste the secret from the agent card.
- Tick Pipeline events, Merge request events, Release events and Deployment events.
- Press Add webhook, then Test and choose Pipeline events.
WARNING: The secret is private. It proves to your agent that a message really came from GitLab.
Part 3. Test it
- Press Save and test on the card (paste the secret first if the card asks you to).
YOU SHOULD SEE: green words saying Connected. The Test button in GitLab sends a first event; it appears in Activity.
If something is wrong
- GitLab says the test failed: open Edit on the webhook and check the URL starts with https and ends in /event, and that the Secret token matches.
All help guides · Every agent feature · AI receptionist by industry
Questions
What if this happens: GitLab says the test failed?
open Edit on the webhook and check the URL starts with https and ends in /event, and that the Secret token matches.