Connect Stripe

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

Short answer: GOAL: your agent hears about failed payments, upcoming invoices, refunds and paid checkouts. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to Stripe 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 failed payments, upcoming invoices, refunds and paid checkouts. TIME: about 10 minutes. COST: free. YOU NEED: your agent running with a public address (Connect, Permanent address) and sign-in to Stripe as the owner or an admin.

TIP: You can't break anything. A webhook is only a message Stripe 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 stripe 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 Stripe

  1. In Stripe open [[Developers > Webhooks > Add endpoint]].
  2. Endpoint URL: paste the agent's address.
  3. Select events: invoice.payment_failed, invoice.upcoming, charge.refunded and checkout.session.completed. For invoice follow-up (optional) also add invoice.created, invoice.overdue and invoice.paid.
  4. Press Add endpoint. On the endpoint's page reveal the Signing secret (it starts with whsec_) and copy it.
  5. Paste it into the agent card and press Save and test.

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

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. Use Stripe's Send test webhook button on the endpoint and it appears in Activity.

If something is wrong

  • Stripe shows the endpoint as failing: the agent's address is wrong or the computer is off. Open the endpoint and press Resend after fixing it.
  • Bad signature in Activity: paste the signing secret again.

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

Questions

What if this happens: Stripe shows the endpoint as failing?

the agent's address is wrong or the computer is off. Open the endpoint and press Resend after fixing it.

What if this happens: Bad signature in Activity?

paste the signing secret again.