Overview

This guide highlights common issues that can occur when setting up Begini and how to resolve them.

Most setup problems are straightforward and are usually caused by configuration gaps, incorrect identifiers or misunderstandings in the integration flow.

This guide is designed to help you quickly identify and fix these issues so you can move forward without delay.

Assessment links not working

Issue

Generated assessment links do not open correctly or fail to load for users.

Common causes

• Incorrect or inactive deployment selected
• Links not generated properly
• Links shared incorrectly (e.g. truncated or modified)
• Network or device-related issues

How to fix

• Confirm the correct deployment was selected in the Link Generator
• Regenerate the links and test again
• Ensure links are shared in full and not altered
• Test on multiple devices or networks

Assessment not completing properly

Issue

Users are unable to complete the assessment or drop off before completion.

Common causes

• Poor network connectivity
• Device compatibility issues
• User confusion or unclear instructions
• Interruptions during the assessment

How to fix

• Test the assessment flow across different devices
• Ensure instructions are clear and simple for users
• Encourage users to complete the assessment in one session
• Monitor completion rates in Beacon to identify patterns

Results not appearing in Beacon

Issue

Assessments are completed but results are not visible in the Beacon dashboard.

Common causes

• Assessment not fully completed
• Delay in processing (rare but possible)
• Viewing the wrong deployment or environment
• Filtering or search settings hiding results

How to fix

• Confirm the assessment reached full completion
• Refresh and check the correct deployment in Beacon
• Review any filters applied in the dashboard
• Re-run a test assessment to confirm behaviour

Results not matching the correct user

Issue

Results are generated but cannot be matched to the correct user in your system.

Common causes

• Incorrect or missing Unique ID
• Reuse of the same identifier across multiple users
• Mismatch between internal IDs and submitted values

How to fix

• Ensure a stable and unique identifier is used for each user
• Verify that the correct Unique ID is passed during session creation or link generation
• Check how IDs are mapped within your internal systems

Incorrect deployment or configuration used

Issue

Assessments are running, but results do not match expectations.

Common causes

• Wrong deployment selected
• Incorrect configuration applied
• Using a test deployment in a live scenario

How to fix

• Confirm the correct deployment is being used
• Review deployment configuration in Beacon
• Ensure test and production setups are clearly separated

Webhooks not receiving data

Issue

Results are generated but not received in your system via webhook.

Common causes

• Webhook endpoint not configured correctly
• Endpoint not accessible
• Incorrect environment being used
• Events not properly subscribed

How to fix

• Verify the webhook endpoint URL
• Ensure the endpoint is publicly accessible
• Confirm webhook configuration matches the correct environment
• Test webhook delivery using a controlled assessment

API integration issues

Issue

API-based integration is not behaving as expected.

Common causes

• Incorrect API key
• Missing or incorrect parameters
• Incorrect Integration ID
• Environment mismatch (sandbox vs production)

How to fix

• Confirm the correct API key is being used
• Review request structure and required fields
• Verify Integration ID is correct
• Ensure you are using the correct environment

Data not flowing into internal systems

Issue

Results are generated but not being used within your internal workflow.

Common causes

• Missing integration between Begini and internal systems
• Webhook or API handling not implemented fully
• Incorrect mapping of fields or identifiers

How to fix

• Confirm how results are being received (API or webhook)
• Review internal handling of Begini outputs
• Ensure Unique IDs are correctly mapped to your system

Slow or inconsistent performance

Issue

Assessments or result processing appear slower than expected.

Common causes

• Network conditions
• Device performance
• High load during testing
• Incomplete or interrupted sessions

How to fix

• Test across different devices and networks
• Ensure users are completing assessments in stable conditions
• Monitor behaviour in Beacon to identify patterns

When to contact support

If you are still experiencing issues after working through the above:

• Gather details of the issue
• Include example assessment sessions if possible
• Provide information on your setup and environment

This will help speed up resolution.

Next steps

If your setup is now working as expected, you can move forward with:

• Quick Start Guide
• Integration Overview
• Go Live Checklist
• Webhooks Overview
• Security Overview