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

  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 gitlab 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 GitLab

  1. Open your project on GitLab, then [[Settings > Webhooks > Add new webhook]].
  2. URL: paste the agent's address.
  3. Secret token: paste the secret from the agent card.
  4. Tick Pipeline events, Merge request events, Release events and Deployment events.
  5. 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

  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. 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.