Weave Code
Laravel There There Laravel Package
spatie/laravel-there-there
Expose your Laravel app data as JSON for There There. Configure a secret and endpoint, validate incoming requests, and register a sidebar callback to return relevant customer info when agents open a ticket, shown in There There’s sidebar.
Expose application data as JSON for There There
Frequently asked questions about Laravel There There
- How do I install and configure spatie/laravel-there-there in my Laravel project?
- Run `composer require spatie/laravel-there-there` to install. Publish the config with `php artisan vendor:publish --tag=there-there-config`, then set your There There secret in `.env` under `THERE_THERE_SECRET`. The default endpoint is `/there-there`, but you can customize it in the config.
- What Laravel versions does this package support?
- The package is designed for Laravel 10+ (as of its 2026 release). Ensure your project uses PHP 8.1+ for full compatibility. Check the package’s GitHub for updates if you’re using an older Laravel version.
- How do I customize the data shown in There There’s sidebar?
- Use the `ThereThere` facade to register a sidebar callback in a service provider. Return `SidebarItem` objects or JSON data via a closure. For example, `ThereThere::sidebar(fn (ThereThereRequest $request) => SidebarItem::make('User', $user->name)->value($user->email));`.
- Is the package secure? How do I validate incoming requests?
- The package includes `IsValidThereThereRequest` middleware to validate requests using your shared secret. Ensure this middleware is in your endpoint’s stack (default config includes it). Never expose sensitive data—sanitize outputs and restrict access via Laravel’s middleware or policies.
- Can I reuse existing Laravel API routes for There There integration?
- Yes, but it’s recommended to create a dedicated endpoint for There There to avoid mixing concerns. The package provides a clean way to structure data specifically for support workflows. Use middleware like `api` or custom validation to ensure consistency.
- What happens if the Laravel endpoint fails during a support session?
- There There may show an error or fallback to cached data, depending on its configuration. Implement graceful degradation in your callback (e.g., return minimal data or a user-friendly message) and consider logging failures for debugging.
- How do I handle sensitive data (e.g., passwords, payment details) in the sidebar?
- Exclude sensitive fields by filtering data in your callback or using Laravel’s accessors. For example, `SidebarItem::make('Order')->value($order->id)->hide($order->payment_token)`. Always validate and sanitize outputs before returning them to There There.
- Are there performance concerns with high volumes of There There API calls?
- The package is lightweight, but high traffic could impact performance. Test under load and consider rate-limiting or queueing requests if needed. Use Laravel’s caching or database query optimizations to reduce latency for support agents.
- What alternatives exist for integrating Laravel with There There?
- If you need more flexibility, you could build a custom API endpoint using Laravel’s routing and middleware. However, this package provides a dedicated, secure solution tailored to There There’s sidebar requirements. Alternatives like Zendesk or Intercom integrations would require different packages.
- How do I test the There There integration in my Laravel app?
- Mock There There requests using `ThereThereRequest` in PHPUnit tests. Verify your callback returns the expected `SidebarItem` objects or JSON. Test edge cases like invalid secrets or missing data to ensure robustness. The package’s GitHub includes tests for reference.
Weaver
How can I help you explore Laravel packages today?