PHPackages                             keithbrink/helpscout-app-spark - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. keithbrink/helpscout-app-spark

ActiveLibrary[API Development](/categories/api)

keithbrink/helpscout-app-spark
==============================

A Helpscout integration package for Laravel Spark that allows you to add information about tickets created by customers in Helpscout.

0.0.9(6y ago)00MIT

Since Jun 17Compare

[ Source](https://github.com/keithbrink/helpscout-app-spark)[ Packagist](https://packagist.org/packages/keithbrink/helpscout-app-spark)[ RSS](/packages/keithbrink-helpscout-app-spark/feed)WikiDiscussions Synced 2d ago

READMEChangelog (9)Dependencies (2)Versions (10)Used By (0)

HelpscoutSpark
==============

[](#helpscoutspark)

An Helpscout integration package for [Laravel Spark](https://spark.laravel.com/) that allows you to add information about tickets created by customers in Helpscout.

It includes two separate functions:

1. It adds an endpoint for a [Helpscout Dynamic App](https://developer.helpscout.com/custom-apps/dynamic/) to display information about the user's billing plan and historical data.
2. It accepts webhooks from Helpscout and processes them based on rules that you set up. By default, it will tag each new ticket with the user's current billing plan.

Installation
------------

[](#installation)

This version requires [PHP](https://php.net) 7, and supports Laravel 5.5+ and Spark 5+.

To get the latest version, simply require the project using [Composer](https://getcomposer.org):

```
$ composer require keithbrink/helpscout-app-spark

```

Configuration - Custom App
--------------------------

[](#configuration---custom-app)

Create a custom app in Helpscout, and point the callback URL to your app URL + the following endpoint:

`/helpscout-spark-app/custom-app`

Add the secret key for the custom app in your .env file:

`HS_SPARK_CUSTOM_APP_SECRET=xxxxxx`

Configuration - Webhook Rules
-----------------------------

[](#configuration---webhook-rules)

Create a new app in Helpscout (under My Apps), and add the following keys in your .env file:

```
HS_AUTH_TYPE=client_credentials
HS_APP_ID=xxx
HS_APP_SECRET=xxx

```

Then, create a new webhook for the endpoint:

`/helpscout-spark-app/webhooks`

and add your secret key in your .env file:

```
HS_SPARK_WEBHOOK_SECRET=xxx

```

Usage
-----

[](#usage)

Out of the box, you will have a custom app with the user's current billing plan and other customer data on each ticket, and the webhook will add a tag for the user's current billing plan to each ticket that is created.

It is simple to add your own information to either the custom app or new rules to handle Helpscout webhooks.

Add Custom App Items
--------------------

[](#add-custom-app-items)

To add more items to the custom app, simply copy the `KeithBrink/HelpscoutSpark/CustomAppData/Items/Plan`, including extending the `BaseItem` and implementing the `ItemContract`.

Change the `getValue` and `getName` function to whatever you like.

Then, add your rule in your `AppServiceProvider` register function:

```
\KeithBrink\HelpscoutSpark\CustomAppData\Items::$items[] = YourItem::class;

```

Add Webhook Rule
----------------

[](#add-webhook-rule)

To add another webhook rule, simply copy the `KeithBrink/HelpscoutSpark/WebhookRules/Rules/TagConversationWithPlan`, including extending the BaseRule and implementing the RuleContract.

The `parseWebhook` function accepts the webhook, here you should set any properties that you will need from the webhook.

Then, handle the webhook, including interacting with the Helpscout API if necessary, in the `handle` function.

Then, add your rule in your `AppServiceProvider` register function:

```
\KeithBrink\HelpscoutSpark\WebhookRules\Rules::$rules[] = YourRule::class;

```

License
-------

[](#license)

HelpscoutSpark is licensed under [The MIT License (MIT)](LICENSE).

###  Health Score

22

—

LowBetter than 21% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~34 days

Recently: every ~68 days

Total

9

Last Release

2296d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/15267205?v=4)[Keith Brink](/maintainers/KeithBrink)[@keithbrink](https://github.com/keithbrink)

### Embed Badge

![Health badge](/badges/keithbrink-helpscout-app-spark/health.svg)

```
[![Health](https://phpackages.com/badges/keithbrink-helpscout-app-spark/health.svg)](https://phpackages.com/packages/keithbrink-helpscout-app-spark)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)