Kit de Inicio de Telefonía Personalizada
Utiliza el Kit de Inicio de Telefonía Personalizada para integrar el sistema CRM de SendPulse con cualquier solución de telefonía externa. Ofrece rutas listas para usar y ejemplos PHP utilizando Laravel. El kit también incluye Docker para acelerar la implementación y el paquete https://packagist.org/packages/sendpulse/market-rest-api para interactuar con las herramientas de SendPulse.
Este artículo te guiará a través de cómo configurar y empezar con el Kit de Inicio de Telefonía Personalizada.
Requisitos del entorno
El entorno de desarrollo debe soportar PHP versión 8.2 o superior. Puedes instalar las dependencias utilizando Composer.
Más información: Introducción a Composer.
Para mantener el estado y gestionar las llamadas en espera, recomendamos configurar una base de datos dedicada. Puedes gestionar el despliegue local con contenedores y una base de datos a través de Docker y Docker Compose.
Antes de empezar, crea un archivo de entorno .env en la raíz del proyecto y añade las credenciales de tu aplicación de Marketplace, SENDPULSE_APP_ID y SENDPULSE_APP_SECRET, junto con la URL para gestionar las llamadas y los webhooks.
Autenticación
Para integrar tu aplicación, debes ponerte en contacto con el equipo de soporte de SendPulse y proporcionar los siguientes datos de la aplicación:
- Nombre de la aplicación.
- ID de la aplicación.
- Ícono de la aplicación en formato PNG, 64x64 px.
- URL para el inicio de la llamada.
El paquete sendpulse/market-rest-api encapsula todo el flujo de autorización dentro del Marketplace de SendPulse.
La ruta de instalación ya está implementada en el proyecto y recupera un código del Marketplace utilizándolo para generar una solicitud con el SENDPULSE_APP_ID y SENDPULSE_APP_SECRET.
Como respuesta, la integración recibe un client_id y client_secret, que se intercambian por el token de acceso a la aplicación del usuario.
Leer más: Flujo de autorización de usuarios.
Ruta de inicio de llamada
Después de iniciar una llamada, envía una solicitud POST a la ruta /custom-telephony/call para pasar los datos de CRM a la solución de telefonía y crear la llamada.
Parámetros de la solicitud:
integrationId |
número | ID de integración de la solución. |
phone |
cadena | Número de teléfono en formato internacional. |
Ejemplo de la solicitud en formato JSON:
{
"integrationId": 123,
"phone": "+380631234567"
}
Una respuesta satisfactoria del servidor devuelve el estado 200 OK.
Gestión de Webhooks
Especifica el conjunto de parámetros que el sistema CRM debe procesar para los eventos de inicio de llamada, fin de llamada y llamada perdida, y pasarlos a la ruta /custom-telephony/webhooks.
Estos parámetros pueden variar dependiendo de la solución de telefonía y pueden incluir:
call_id |
cadena | ID único de la llamada. |
event |
cadena | Evento de inicio o fin de llamada. |
type |
cadena | Tipo de llamada entrante o saliente. |
phone |
cadena | Número de teléfono en formato internacional. |
duration |
número | Duración de la llamada. |
is_success |
booleano | Estado de inicio de la llamada. |
token |
cadena | Token de autorización Webhook. |
Cuando el sistema CRM recibe un evento de llamada perdida, se crea una tarea. Los eventos de fin de llamada activan el cierre del pop-up.
Kit de inicio y estructura del proyecto
Los principales archivos PHP del Kit de Inicio de Telefonía Personalizada se encuentran en el directorio app/ que contiene los subdirectorios Modelos, Controladores, Solicitudes y Repositorios.
Las rutas principales se definen en los archivos routes/web.php y routes/api.php. El punto final de la API /api/boards devuelve una lista de tableros en formato JSON para probar la autenticación y las funciones REST básicas.
Desinstalación de la app
En el proceso de desinstalación de la app, se envía una solicitud POST a la ruta /custom-telephony/uninstall y el usuario es eliminado de la aplicación.
Más información: Flujo de desinstalación.
Última actualización: 22.05.2025
o