Troubleshooting Guide

Solutions for common Meta integration issues, backend crashes, and redirection errors.

Backend Dependencies Exception

NestJS fails to start with UnknownDependenciesException on Role or TenantMembership.

Circular file-level imports between entities (Role <-> TenantMembership).

Switch the relationship definition to use string references instead of classes.

@ManyToOne('Role', (role: any) => role.memberships) // Use string 'Role'

Facebook error: "redirect_uri is not identical to the one used in the OAuth dialog request".

The JS SDK (FB.login) uses a different implicit URI than our backend exchange request.

Use a manual window.open popup to the Facebook dialog URL to explicitly set the redirect_uri.

const fbUrl = `https://www.facebook.com/v19.0/dialog/oauth?client_id=${id}&redirect_uri=${encodedUri}...`;

The /me/businesses endpoint fails with a permission error even after granting scopes.

Restricted access to the business listing endpoint for certain account types.

Use the debug_token endpoint to extract the WABA ID directly from granular_scopes fallback.

const wabaId = debugData.granular_scopes.find(s => s.scope === 'whatsapp_business_management').target_ids[0];

Redirecting to /dashboard after login results in a "Page Not Found" error.

The app requires a workspace slug in the URL which was missing from the redirect path.

Use the state parameter in the OAuth flow to carry the tenant ID and redirect back to the workspace settings.

localStorage.setItem('x-tenant-id', state); router.push('/settings/whatsapp');