innclod/helpdesk-client-php

SDK cliente PHP y Laravel para conectar e interactuar con la API Helpdesk Appclod de forma segura.

dev-main 2026-07-23 21:28 UTC

Requires

• php: >=7.4
• ext-json: *
• guzzlehttp/guzzle: ^7.0

MIT

• Innclod Developers

Published on Packagist.org on 2026-07-24 00:37 UTC

README

Librería cliente SDK para integrarse de forma segura con la API de Mesa de Ayuda (Helpdesk) de Appclod sin exponer las llaves de seguridad en el frontend.

Instalación

composer require innclod/helpdesk-client-php

Requisitos

• PHP >= 7.4
• Extensión json

Uso

1. Obtener Token en el Backend

Genera un token temporal para el widget asociándolo al correo del usuario:

use Innclod\HelpdeskClient\HelpdeskClient;

$helpdesk = new HelpdeskClient(
    'TU_CLIENT_ID',
    'TU_CLIENT_SECRET',
    'https://api.tuservicio.com/api/v1'
);

$scopedToken = $helpdesk->generateWidgetToken('[e-mail]');

2. Inicializar Widget en el Frontend

Pasa el token obtenido al frontend para inicializar el widget:

<script src="https://cdn.tuservicio.com/widgets/helpdesk-widget.js"></script>
<script>
    HelpdeskWidget.init({
        token: '<?php echo $scopedToken; ?>',
        apiBaseUrl: 'https://api.tuservicio.com/api/v1',
        user: {
            email: '[e-mail]'
        }
    });
</script>