Integrations FAQ

This page covers common issues with CRM integrations (GoHighLevel and HubSpot), calendar connections, webhooks, and other third-party integrations.

GoHighLevel (GHL)

GHL connection keeps disconnecting

GHL OAuth tokens expire periodically. When this happens:

1. Navigate to Integrations → GoHighLevel
2. Click Disconnect
3. Click Connect to re-authenticate
4. Authorize the connection in the GHL popup

Contacts not syncing from GHL

1. Check the connection status — Ensure GHL shows as “Connected” on the integrations page.
2. Verify scopes — The GHL integration requires contact read/write permissions. Disconnect and reconnect if scopes were changed.
3. Check the sync log — View recent sync activity in the integration detail page for errors.
4. Manual sync — Click the Sync Now button to force a sync.

GHL workflows not triggering calls

1. Check workflow status — Ensure the workflow is enabled in the BuildVoiceAI workflow editor.
2. Verify the trigger — Confirm the GHL webhook trigger is correctly configured.
3. Check the agent — The workflow must reference an active agent with a phone number.
4. Review execution log — Check Workflows → Execution Log for error details.

HubSpot

HubSpot sync failures

1. Re-authorize the connection — HubSpot tokens can expire. Go to Integrations → HubSpot and click Reconnect.
2. Check required scopes — Disconnect and reconnect to ensure all necessary scopes are granted. Required scopes include contacts, deals, and timeline events.
3. Check HubSpot subscription — Some API features require a HubSpot Professional or Enterprise plan.

Contact properties not updating in HubSpot

1. Check property mapping — Verify that BuildVoiceAI fields are mapped to the correct HubSpot properties.
2. Check custom properties — If you are using custom HubSpot properties (like ai_call_tags), ensure they exist in your HubSpot account.
3. Check API limits — HubSpot has API rate limits. High-volume operations may be throttled.

HubSpot tags not appearing

BuildVoiceAI uses a custom property called ai_call_tags in HubSpot. To ensure it works:

1. Verify the ai_call_tags property exists in your HubSpot contact properties
2. Check that the property type is set to “single-line text”
3. Tags are stored as semicolon-separated values (e.g., qualified;interested;follow-up)

Calendar Integrations

Google Calendar booking fails

1. Check calendar connection — Verify Google Calendar is connected in Integrations.
2. Check availability — Ensure the calendar has available time slots. The agent cannot book if the calendar is fully blocked.
3. Timezone mismatch — Confirm the agent’s timezone matches the calendar timezone. Mismatches can cause bookings at unexpected times.
4. Re-authorize — Google OAuth tokens can expire. Disconnect and reconnect the calendar.

Calendly links not working

1. Verify the Calendly link — Ensure the link is valid and public.
2. Check event type — The Calendly event type must have available times.
3. Connection status — Verify Calendly is connected in Integrations.

Webhooks

Webhook not firing

1. Check the webhook URL — Ensure the URL is correct and publicly accessible.
2. Check the workflow — The workflow containing the webhook action must be enabled.
3. Check conditions — Verify the workflow conditions are met. For example, if the webhook only fires on completed calls, failed calls will not trigger it.
4. Check the execution log — Go to Workflows → Execution Log to see if the workflow ran and what happened.

Webhook receiving errors

1. Check your endpoint — Ensure your server returns a 200 status code within 10 seconds.
2. Check HTTPS — Webhook URLs must use HTTPS.
3. Check firewall — Your server must be accessible from the public internet.
4. Check payload handling — Ensure your server correctly parses the JSON body.

Webhook signature verification failing

1. Use the raw body — Compute the HMAC on the raw request body, not the parsed JSON.
2. Use the correct secret — The secret for verification is your API key.
3. Use timing-safe comparison — Standard string comparison can fail due to timing differences.

Slack

Slack notifications not appearing

1. Check connection — Verify Slack is connected in Integrations.
2. Check channel — Ensure the selected channel still exists and the BuildVoiceAI bot is a member.
3. Re-authorize — Disconnect and reconnect the Slack integration.

General Integration Tips

• Always disconnect before reconnecting — This ensures a clean OAuth flow.
• Check the integration detail page — Most integrations show a sync log with recent activity and errors.
• Keep API keys current — If you rotate keys on the provider side, update them in BuildVoiceAI immediately.