Skip to main content

PosHUB integration

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

Idn

poshub

Title

poshub

Registry

production

Module

poshub_integration

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

  1. In the Builder, go to Attributes and paste your PosHUB admin credentials into the corresponding fields.

  2. Click Publish All. This generates the webhook URLs Newo will provide to PosHUB.

  3. After publishing, copy the webhook URLs displayed in the Builder settings.

Configure PosHUB

  1. In the PosHUB Developer Portal, create a new application in the Marketplace category.

  2. Paste the webhook URLs from Newo into the application's webhook configuration fields.

  3. Copy the Client ID and Client Secret generated by PosHUB.

  4. From the PosHUB dashboard URL, extract your Reseller ID.

Final publish

  1. Return to the Builder and paste the Client ID, Client Secret, and Reseller ID into the corresponding attributes.

  2. Click Publish All. This populates the location dropdown and loads the synchronized menu.

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

I will place your order right now and come back with the confirmation.

Check order status

I will check your order status right now and come back with the details.

Cancel order

I will cancel your order right now and come back with the confirmation.

❗❗ 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:

  1. Location setup — confirm the location dropdown is populated and a location is selected.

  2. Menu — ask about a menu item and confirm the AI Employee responds using only synchronized menu data, with no invented items.

  3. Place order — complete an ordering conversation and verify the order appears in PosHUB with the correct items and customer details.

  4. Order status — ask for the status of an order and confirm the AI Employee queries PosHUB in real time.

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

Did this answer your question?