Connect PosHUB to your AI Employee to let restaurant customers place, check, and cancel orders through voice, SMS, or chat — using a live-synchronized menu without any manual handoff.
Prerequisites
An active PosHUB account with external API access enabled
Admin or reseller credentials for your PosHUB account
Access to the PosHUB Developer Portal
At least one published menu in a PosHUB location
Access to the Builder with publish permissions
Estimated setup time: 15–45 minutes depending on account provisioning status.
Create the PosHUB project
Add the PosHUB integration module to the customer's Builder. Follow the steps in Create a new project using these values:
Field | Value |
|
|
|
|
|
|
|
|
Ensure Auto update enabled is turned on, then click Create.
Once the project is created, click the three dots icon next to it and select Force Update Project to pull the latest module version.
Connect PosHUB to the Newo platform
The setup follows a credential exchange between Newo and PosHUB. Complete the steps in order.
First publish
In the Builder, go to Attributes and paste your PosHUB admin credentials into the corresponding fields.
Click Publish All. This generates the webhook URLs Newo will provide to PosHUB.
After publishing, copy the webhook URLs displayed in the Builder settings.
Configure PosHUB
In the PosHUB Developer Portal, create a new application in the Marketplace category.
Paste the webhook URLs from Newo into the application's webhook configuration fields.
Copy the Client ID and Client Secret generated by PosHUB.
From the PosHUB dashboard URL, extract your Reseller ID.
Final publish
Return to the Builder and paste the Client ID, Client Secret, and Reseller ID into the corresponding attributes.
Click Publish All. This populates the location dropdown and loads the synchronized menu.
Select your PosHUB location from the dropdown, then click Publish All again to finalize.
How menu synchronization works
The AI Employee uses a cached menu snapshot to answer menu questions and place orders — it does not make live API calls during the conversation. This cache is refreshed when:
Publish All completes for the first time
PosHUB fires a webhook when a menu is published in the portal
The cache expires (default: every 6 hours)
The integration narrows menu context to relevant categories per conversation turn, so the AI Employee only references items related to what the customer is asking about.
Trigger phrases
The integration uses exact phrases to fire each ordering action. These must not be edited, reworded, or translated.
Action | Trigger phrase |
Place order |
|
Check order status |
|
Cancel order |
|
❗❗ IMPORTANT
Do not alter any trigger phrase above. Modifying a trigger phrase will prevent the associated action from firing. If a phrase has been changed, restore it exactly and click Publish All.
Test the integration
After completing setup, verify each capability using the Newo conversation interface:
Location setup — confirm the location dropdown is populated and a location is selected.
Menu — ask about a menu item and confirm the AI Employee responds using only synchronized menu data, with no invented items.
Place order — complete an ordering conversation and verify the order appears in PosHUB with the correct items and customer details.
Order status — ask for the status of an order and confirm the AI Employee queries PosHUB in real time.
Cancel order — request a cancellation and verify PosHUB's response.
Troubleshooting
Symptom | Likely cause | Fix |
Auth fails on Publish All | Invalid credentials or password grant not enabled | Verify credentials match the Developer Portal; contact PosHUB support to enable password grant if needed |
Empty location dropdown | No locations under reseller, or incorrect Reseller ID | Confirm the account has provisioned locations; verify the Reseller ID is correct |
AI Employee ignores order requests | Trigger phrase edited or removed | Restore the exact trigger phrase from the table above and re-publish |
AI Employee shows outdated menu | Webhook not configured or not firing | Confirm the webhook URL is pasted in PosHUB; republish a menu in PosHUB to fire the webhook |
Limitations
One PosHUB location per Newo project. For multiple locations, create separate projects.
Payment collection is not handled in the conversation — PosHUB manages payment separately.
Order cancellation depends on PosHUB's acceptance rules for the order's current state.
The AI Employee cannot edit menu items from the conversation.
