Connect HostBill
A step-by-step guide with pictures, from the Speakvora agent's own Connect tab.
Short answer: This connects your own HostBill account to your Speakvora agent. Then a customer can text where is order 1234 and get the answer in seconds, and the agent can send status and tracking texts. The agent only reads. It can never create, change or delete anything in HostBill. Only the status word and the order number are.
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.
This connects your own HostBill account to your Speakvora agent. Then a customer can text *where is order 1234* and get the answer in seconds, and the agent can send status and tracking texts. The agent only reads. It can never create, change or delete anything in HostBill. Only the status word and the order number are ever texted back, never names, prices, items or addresses.
TIP: You need about 15 minutes, a computer, and the sign-in for your HostBill account (the owner or a manager). You can't break anything: if a step does not work, nothing has changed and you can just try again. The keys and screens below are made-up examples.
NOTE: This guide was written from HostBill's public developer documentation (a few details could not be confirmed) and has not been tried yet on a live HostBill account. If a screen looks different from what is described, press Connect, then Download report, and send it to support. We fix it for everyone.
Who this is for: website hosting internet. How HostBill gives access: You create the key yourself in your own account; no approval is needed. What it costs you: The HostBill API is part of the HostBill software you already run; no extra charge is stated in the API docs.
Part 1. Get your key from HostBill
Do this on your computer, in a new browser tab, signed in to HostBill.
- Sign in to your HostBill admin area as an administrator.
- Open [[Settings > System Settings > Security settings > API Access]].
- Add a new API access entry and save it; HostBill shows the API ID and API key.
- Open the API ID details page and allow only the read-only functions getOrders and getOrderDetails.
- Restrict the entry to the IP address Speakvora will call from, if you know it.
- Copy your HostBill address, the API ID and the API key into Speakvora.
WARNING: If HostBill asks which permissions to give, tick only the read-only ones: Allow only getOrders, getOrderDetails (read-only functions), Restrict the key to the IP address of the computer running Speakvora. Never give write or admin access.
TIP: To copy the key, click inside the box that shows it, press Command + C on a Mac or Ctrl + C on Windows (or right-click and choose Copy). Nothing will look different. It is now in your clipboard, ready to paste. Keep it private: anyone who has it can read your orders.
Part 2. 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 HostBill in the box that says Find an app (1), or scroll down the list.
- Press HostBill. A card slides up. (If you only see apps for your own kind of business, that is on purpose: your agent only shows the systems that make sense for it.)



Part 3. Paste it in
3 boxes to fill in. Click inside a box, press Command + V on a Mac or Ctrl + V on Windows, then move to the next:
- Your HostBill address. The web address you sign in to HostBill on, without https:// and without /admin.
- API ID. Shown on the API ID details page after you add an API access entry.
- API key (secret: it stays on this computer and is never shown again, only the last few characters). Generated together with the API ID under Settings > System Settings > Security settings > API Access.

TIP: Pasted by mistake into the wrong box? Click the box, press Command + A (Ctrl + A on Windows) to select all, then paste again.
Part 4. Test it
- Press the orange Save and test button.
- HostBill has no safe read-only check we can run, so nothing is called. The connection is used for real the first time a customer asks about an order, and any problem shows in Activity.

YOU SHOULD SEE: green words starting with Connected. (here: *Saved* and the sentence about the first customer)
WARNING: Red words mean it did not work yet. Read them, then see If something is wrong below. Nothing bad happened.
What happens next
- A customer texts something like where is order 1234. The agent answers *Your order 1234 is preparing.* (the status word from HostBill), or *I could not find that order. A team member will check and reply.*
- Each person can ask five times an hour. If HostBill is down, the conversation carries on and the problem is written to Activity.
- Mode: the agent asks HostBill when a customer asks.
If something is wrong
- It says the key was refused (401 or 403): copy the key again from HostBill. Make sure there is no space before or after it, and that it is a live key for the right shop or location.
- It cannot find an order (404): the number is not in HostBill, or HostBill uses a longer number than the one on the receipt.
- It says too many requests (429): wait a minute and press Save and test again.
- HostBill says you need a plan or approval: HostBill's documented API sends api_id AND api_key as two query parameters on {your HostBill}/admin/api.php with call=getOrderDetails&id=ORDER_ID (status in details.status). Speakvora's connector contract can send only one credential parameter and one fixed path, so test and order calls are not defined here until the connector supports a second auth parameter. Read endpoints exist: getOrders and getOrderDetails.
- Still stuck? Press Connect, then Download report, and email it to support. It never contains keys or customer messages.
If your plan has no API
- Ask the owner to forward order numbers and statuses by email or export from Orders in the HostBill admin.
HostBill's own instructions: https://api2.hostbillapp.com/
All help guides · Every agent feature · AI receptionist by industry
Questions
What if this happens: It says the key was refused (401 or 403)?
copy the key again from HostBill. Make sure there is no space before or after it, and that it is a live key for the right shop or location.
What if this happens: It cannot find an order (404)?
the number is not in HostBill, or HostBill uses a longer number than the one on the receipt.
What if this happens: It says too many requests (429)?
wait a minute and press Save and test again.
What if this happens: HostBill says you need a plan or approval?
HostBill's documented API sends api_id AND api_key as two query parameters on {your HostBill}/admin/api.php with call=getOrderDetails&id=ORDER_ID (status in details.status). Speakvora's connector contract can send only one credential parameter and one fixed path, so test and order calls are not defined here until the connector supports a second auth parameter. Read endpoints exist: getOrders and getOrderDetails.
What if this happens: Still stuck??
Press Connect, then Download report, and email it to support. It never contains keys or customer messages.