FAQs

Q: How do I access integrations in MagicBlocks?
A: Go to your workspace → Integrations from the left sidebar. You’ll see sections like CRMs, Calendars, SMS, Analytics, Webhooks, and API.

Each integration includes setup instructions and connection status indicators.

Q: Do I need coding skills to use integrations?
A: No. All integrations use simple no-code connectors or guided API fields. Advanced users can use Webhooks or the MagicBlocks API for full control.

Q: Can I use multiple integrations at once?
A: Yes. You can connect multiple CRMs, calendar systems, and analytics tools at the same time. MagicBlocks handles routing automatically based on your Action or Journey setup.

Calendars & Scheduling

Q: Which calendar tools does MagicBlocks integrate with?
A: Currently supported:

• Calendly
• Google Calendar (via OAuth, coming soon)
• Custom Webhooks for other scheduling tools.

Q: How do I connect Calendly?
A:

1. Go to Integrations → Calendly.
2. Click Connect Account and log in via OAuth.
3. Choose the event type (e.g., “15-minute intro call”).
4. Add a “Book a Call” Action in your Journey and select Calendly from the dropdown.

Your AI Agent will automatically share and trigger that booking link.

Q: Can my AI Agent check available times dynamically?
A: Yes — when integrated with Calendly, the Agent can query and display open time slots using Dynamic Tokens.

CRMs (HubSpot & HighLevel)

Q: What CRM tools does MagicBlocks support?
A: Native integrations include:

• HubSpot CRM
• HighLevel CRM (GoHighLevel)
  You can also connect to any CRM via Webhooks or Zapier.

Q: How do I send leads automatically to my CRM?
A:

In your Journey, go to the Actions tab.

Add an Action → “Send to CRM”.

Select your connected CRM (HubSpot or HighLevel).

Map fields such as Name, Email, Phone, and Service of Interest.

Click Save & Publish.

Every qualified lead captured by your Agent will sync instantly.

Q: What if leads aren’t appearing in my CRM?
A: Double-check:

CRM integration is connected (token valid).

Field mappings are correct.

Journey block includes a lead qualification trigger.
You can also review Sessions → Actions Log to confirm data sent.

Q: Can I connect multiple CRMs?
A: Yes, you can connect more than one CRM. Use conditional logic in Journeys (e.g., “if region = US, send to HubSpot; if AU, send to HighLevel”).

SMS Integration

Q: How do I send SMS messages through MagicBlocks?
A: Connect Twilio under Integrations → SMS.
Add your Account SID and Auth Token, then assign your SMS-enabled number.

You can then create SMS Agents or trigger text notifications directly from Actions.

Q: My SMS messages aren’t being delivered. Why?
A: Check:

• Your number is SMS-enabled.
• US users have 10DLC registration approved.
• The message content complies with Twilio’s messaging policy.
• You’ve set the correct destination country format (e.g., +61, +1).

Q: Can I track SMS performance?
A: Yes — the Dashboard → Analytics tab includes SMS delivery and reply metrics. You can also use Twilio logs for message-level insights.

Google Analytics

Q: Can I track Agent performance in Google Analytics?
A: Yes. You can link your GA4 Measurement ID in Integrations → Google Analytics. MagicBlocks automatically sends key events such as:

• Chat Started
• Lead Captured
• Conversation Completed
• Goal Achieved

Q: Does it support custom events?
A: Yes — you can define custom event names in Journey → Actions → Analytics Tracking.

Webhooks

Q: What’s the difference between Webhooks and CRM integration?
A: Webhooks are flexible connections to any system via HTTP — ideal when no native integration exists. CRMs are pre-built connectors with mapped fields.

Q: Can I send data to multiple endpoints?
A: Yes. You can attach multiple Webhook Actions to different Journeys or conditions (e.g., send lead data to both CRM and Slack).

Q: How do I secure my Webhook connection?
A: Add authentication headers (API Key or Bearer Token) and use HTTPS endpoints only. MagicBlocks encrypts payloads during transmission.

API Access

Q: What can I do with the MagicBlocks API?
A: Use the API to:

Create and manage Agents

Retrieve conversations and leads

Send or receive chat messages programmatically

Connect custom dashboards or apps

Q: Where can I find API keys?
A: Go to Integrations → API → click Generate New Key.
Copy the key once — it’s only shown on creation for security.

Q: How do I test the API?
A: Use tools like Postman or cURL. The API accepts standard JSON payloads and uses Bearer Token authentication.

Q: Is there rate limiting?
A: Yes. Free plans allow 60 requests per minute; paid plans have higher limits. If you exceed the threshold, you’ll receive a 429 Too Many Requests error.

Best Practices

✅ Always test integrations in a sandbox or test Agent before going live.
✅ Use consistent field naming between MagicBlocks and external systems.
✅ Refresh CRM tokens periodically to avoid disconnects.
✅ For SMS, double-check opt-in compliance and sender ID.
✅ Use Webhooks or API for advanced or custom workflows.