FAQ & Handoff

Beacon includes built-in FAQ and handoff sections that appear in the panel below the quick actions. Use FAQ for self-service answers and handoff for routing visitors to email, calendar, or external resources.

FAQ

Display collapsible question-and-answer items directly in the Beacon panel.


{
  "faq": {
    "enabled": true,
    "items": [
      {
        "q": "How do I reset my password?",
        "a": "Go to Settings > Security > Reset Password. You'll receive a confirmation email."
      },
      {
        "q": "What payment methods do you accept?",
        "a": "We accept all major credit cards, crypto payments via USDC/ETH, and wire transfers for enterprise."
      },
      {
        "q": "Where can I find the API docs?",
        "a": "Full API documentation is available at docs.example.com.",
        "url": "https://docs.example.com"
      }
    ]
  }
}

FAQ Item Properties

Property	Type	Required	Description
`q`	string	Yes	The question
`a`	string	Yes	The answer
`url`	string (URL)	No	Optional link for “Learn more”

Items render as collapsible accordions — the question is always visible, and clicking it reveals the answer.

Handoff

Handoff options provide alternative contact methods when quick actions aren’t sufficient.


{
  "handoff": {
    "emailCapture": {
      "enabled": true,
      "to": "support@example.com"
    },
    "calendar": {
      "enabled": true,
      "url": "https://cal.com/example/support"
    },
    "externalLinks": [
      { "label": "Discord Community", "url": "https://discord.gg/example" },
      { "label": "Status Page", "url": "https://status.example.com" }
    ]
  }
}

Email Capture

When enabled, displays an email input form in the panel. Submitted emails are sent to the specified to address and tracked via the handoff_email_submitted analytics event.

Property	Type	Description
`enabled`	boolean	Show or hide the email form
`to`	string (email)	Destination email address

Calendar Booking

When enabled, displays a “Book a Call” button that opens the specified calendar URL.

Property	Type	Description
`enabled`	boolean	Show or hide the calendar button
`url`	string (URL)	Calendar booking URL (Cal.com, Calendly, etc.)

Clicks are tracked via the handoff_calendar_clicked analytics event.

External Links

Additional links displayed at the bottom of the panel.

Property	Type	Description
`label`	string	Link display text
`url`	string (URL)	Link destination