Summary: This guide is for admins and HR managers who want to connect Speakap with Awardco. The integration shows employee recognitions in a widget on the Feed. We cover the required User Sync preparation, the installation steps, and how to fix common setup errors.
About the integration
The Awardco integration automatically shows employee recognitions, both received and given, in a dedicated widget on the Feed. Speakap links a user's profile to their Awardco account based on their unique External ID (XID), which is often the employee ID.
Before you install: align the XID in User Sync
Before installing the app, your IT or HR systems admin must complete one essential mapping step in your User Sync setup:
- Unique ID alignment: The unique employee ID that your HR system sends to Speakap must be identical to the ID used for that same employee inside Awardco.
- The role of the XID: Speakap uses this shared unique ID as the user's XID.
Important: If a user's Speakap XID and their Awardco employee ID do not match exactly, the integration will make mapping errors. Users may then see someone else's recognition data in their Feed widget.
Step-by-step installation
- Open the Speakap Market: Log in to your network with an admin account, open the Speakap Market, and select the Awardco application.
- Add the app: Click the button to add the application to your network.
- Select your audience: Choose the audience or groups that should have access to this integration. Once you confirm the audience, the application is installed.
- Open the configuration settings: Find Awardco in your list of installed applications and click the gear icon to finish the setup.
- Enter your credentials: The configuration screen asks for your Awardco API key and your unique Awardco URL.
- Note: Your company's Awardco administrator can find these credentials in their Awardco account dashboard.
- Done: If the credentials are valid, employee recognitions automatically start appearing in the widget on the Feed.
Troubleshooting
If the widget does not show recognition data, click the app's configuration gear icon and check for these three common errors:
- Missing API key: The key field is empty. Enter your valid API key in the application configuration screen.
- Missing Awardco URL: Make sure the exact web address of your Awardco environment is filled in and saved in the settings.
- XID not configured: The integration cannot find the user's mapping. Check your User Sync setup to make sure it fills in matching XID values for all accounts.
Still stuck?
Email us at technicalimplementations@speakap.nl with your network name, the error you see in the app configuration, and a screenshot, and we'll help you out.