layer7/nj-dialer-client

NJ Dialer API Client

0.0.12 2026-07-03 22:33 UTC

Requires

• php: ^7.4|^8.0
• guzzlehttp/guzzle: ^7.10

Requires (Dev)

• phpunit/phpunit: ^9.5

MIT

• Layer7

Published on Packagist.org on 2026-07-03 22:33 UTC

README

Cliente PHP para NJDialer.

Instalación

composer require layer7/nj-dialer-client

Uso

<?php

use Layer7\NjDialerClient\NJDialerClient;

// Crear instancia con token (siempre se envía en Authorization)
$client = new NJDialerClient('xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx');

// 1) Originar llamada (sin flow)
$r1 = $client->originateCall('[phone]'); // 'source' por defecto 'api'

// 1b) Originar llamada con flow opcional (ejemplo con un paso 'say')
$flow = [
    'steps' => [
        ['action' => 'say', 'text' => 'Hola, este es un mensaje de prueba', 'voice' => 'ES-MX-FEMALE-01']
    ]
];
// $r1 = $client->originateCall('[phone]', 'api', $flow);

// 2) Reproducir audio en la llamada
$r2 = $client->playAudio($r1['call_id'], 'https://example.com/audio.mp3');

// 3) Colgar la llamada
$r3 = $client->hangup($r1['call_id']);

// PHP 7.4+: misma inicialización (constructor con token requerido)

Configuración de la URL base

La URL del receiver se resuelve con esta precedencia:

1. Argumento explícito del constructor: new NJDialerClient($token, 'http://mi-host').
2. Variable de entorno NJ_DIALER_RECEIVER_URL (leída con getenv(), funciona aun con config:cache).
3. Default de producción NJDialerClient::DEFAULT_BASE_URL (https://nj-dialer-receiver.rd.l7labs.art).

// Usa NJ_DIALER_RECEIVER_URL si está definida; si no, el default de prod.
$client = new NJDialerClient($token);

// Override explícito (tiene prioridad sobre la env):
$client = new NJDialerClient($token, 'http://dummy-receiver.nj-dialer.svc.cluster.local');

Backward-compatible: sin env ni argumento, el comportamiento es idéntico al default de producción.

Requisitos

• PHP 7.4+

Licencia

MIT