PHPackages                             tompedals/helpscout-dynamic-app - 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. [Utility & Helpers](/categories/utility)
4. /
5. tompedals/helpscout-dynamic-app

ActiveLibrary[Utility & Helpers](/categories/utility)

tompedals/helpscout-dynamic-app
===============================

A library to assist the creation of Help Scout dynamic apps

0.2.1(9y ago)1773MITPHPPHP >=5.6

Since Sep 22Pushed 9y ago1 watchersCompare

[ Source](https://github.com/tompedals/helpscout-dynamic-app)[ Packagist](https://packagist.org/packages/tompedals/helpscout-dynamic-app)[ RSS](/packages/tompedals-helpscout-dynamic-app/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (4)Versions (4)Used By (3)

HelpScout Dynamic App Server
============================

[](#helpscout-dynamic-app-server)

A simple library to verify [Help Scout dynamic app](http://developer.helpscout.net/custom-apps/dynamic/) requests and respond accordingly. Forked from the [official library](https://github.com/helpscout/helpscout-apps-php) to add support for PSR-7 HTTP message interfaces.

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

[](#installation)

This is installable via [Composer](https://getcomposer.org/) as [tompedals/helpscout-dynamic-app](https://packagist.org/packages/tompedals/helpscout-dynamic-app):

```
composer require tompedals/helpscout-dynamic-app

```

Example
-------

[](#example)

Note: The following example uses zendframework/zend-diactoros as the HTTP message implementation.

### Handle a request

[](#handle-a-request)

The request will be verified using the given secret and signature from the request headers.

```
use TomPedals\HelpScoutApp\AppRequestFactory;
use Zend\Diactoros\ServerRequestFactory;

$factory = new AppRequestFactory('secret');
$request = $factory->create(ServerRequestFactory::fromGlobals());

/** @var TomPedals\HelpScoutApp\Model\Customer */
$customer = $request->getCustomer();

/** @var TomPedals\HelpScoutApp\Model\Mailbox */
$mailbox = $request->getMailbox();

/** @var TomPedals\HelpScoutApp\Model\Ticket */
$ticket = $request->getTicket();

/** @var TomPedals\HelpScoutApp\Model\User */
$user = $request->getUser();
```

### Respond to a request

[](#respond-to-a-request)

Set the HTML on the response and get the correct schema for the JSON response.

```
use TomPedals\HelpScoutApp\AppResponse;
use Zend\Diactoros\Response\JsonResponse;

$response = new AppResponse('Test');
$jsonResponse = new JsonResponse($response->getData());
```

### Controller action

[](#controller-action)

A PSR-7 compatible action is available to handle the request and respond accordingly. The action is an invokable class that can be used with Slim, Symfony, Zend Framework, etc.

Implement the `AppHandlerInterface` to handle the `AppRequest` and return the HTML to be rendered within the Help Scout sidebar.

```
class AppHandler implements AppHandlerInterface
{
    public function handle(AppRequest $request)
    {
        // Find customer information
        // Render the template
        // Return the HTML response

        return 'This customer is awesome';
    }
}
```

Pass the `AppHandler` implementation when constructing the action.

```
use TomPedals\HelpScoutApp\AppAction;
use TomPedals\HelpScoutApp\AppHandlerInterface;
use TomPedals\HelpScoutApp\AppRequestFactory;

// implements AppHandlerInterface
$handler = new AppHandler();

$action = new AppAction(new AppRequestFactory('secret'), $handler);
$response = $action($request, $response);
```

###  Health Score

25

—

LowBetter than 36% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

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 ~3 days

Total

3

Last Release

3561d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/0108faaeaf073146f428b1f04b42ba469d97bf2a9d14f31183a2b541f3de8197?d=identicon)[tompedals](/maintainers/tompedals)

---

Tags

helpscout

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/tompedals-helpscout-dynamic-app/health.svg)

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

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k532.1M2.5k](/packages/aws-aws-sdk-php)[neuron-core/neuron-ai

The PHP Agentic Framework.

2.0k496.1k33](/packages/neuron-core-neuron-ai)[spatie/laravel-export

Create a static site bundle from a Laravel app

672139.5k6](/packages/spatie-laravel-export)[razorpay/ifsc

Razorpay IFSC Codes Library

385204.4k](/packages/razorpay-ifsc)[anthropic-ai/sdk

Anthropic PHP SDK

160372.1k14](/packages/anthropic-ai-sdk)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35729.6k2](/packages/telnyx-telnyx-php)

PHPackages © 2026

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