Overview

This guide helps you identify and resolve common operational issues when using Begini.

Issues typically fall into a few key areas:

• Assessment flow
• Data delivery
• Integration setup
• User access and configuration

---

Common issue categories

1. Assessments not completing

Symptoms

• Users start but do not finish assessments
• Low completion rates
• Sessions appear incomplete

Possible causes

• User drop-off during assessment
• Poor user experience or unclear instructions
• Technical interruptions (connectivity, device issues)

What to check

• Completion rate trends in Beacon
• Time to complete
• Drop-off points

Resolution

• Review assessment flow and instructions
• Ensure stable internet connection
• Test across different devices

---

2. No results received (webhooks)

Symptoms

• No data received in your system
• Missing score or completion events

Possible causes

• Webhook endpoint not configured correctly
• Endpoint not publicly accessible
• Failed webhook delivery

What to check

• Webhook endpoint URL
• Server availability
• Logs for incoming requests

Resolution

• Ensure endpoint is reachable over HTTPS
• Validate webhook configuration
• Check Webhooks Overview and Testing Webhooks

---

3. Webhook failures

Symptoms

• Webhooks received but not processed
• Repeated failures or retries

Possible causes

• HMAC verification failing
• Incorrect payload handling
• Server errors

What to check

• Signature validation logic
• Raw payload handling
• Server logs and error responses

Resolution

• Verify HMAC implementation
• Ensure correct handling of raw JSON
• Return HTTP 200 for successful processing

---

4. Incorrect or missing scores

Symptoms

• Scores not appearing
• Unexpected results

Possible causes

• Incomplete assessments
• Incorrect integration setup
• Misinterpretation of data

What to check

• Event type (e.g. score.complete vs application.complete)
• Payload structure
• Assessment completion status

Resolution

• Ensure you are processing the correct webhook events
• Review Webhook Payload Structure
• Confirm full completion before using results

---

5. Integration issues

Symptoms

• API requests failing
• Sessions not being created

Possible causes

• Invalid API key
• Incorrect Integration ID
• Environment mismatch

What to check

• API Authentication setup
• Integration ID
• Sandbox vs production configuration

Resolution

• Verify credentials
• Ensure correct environment
• Review Integration Overview

---

6. Link generator issues (no-code)

Symptoms

• Links not working
• Users unable to access assessments

Possible causes