Las acciones son automatizaciones que se ejecutan cuando ocurren ciertos eventos en el sistema, como enviar o recibir un mensaje.
Existen dos tipos de acciones: Hooks (para conectar con sistemas externos) y Respuestas Automáticas (para responder mensajes sin intervención manual).
Los hooks envían una solicitud HTTP GET a una URL externa cada vez que ocurre un evento. A diferencia de los webhooks, los hooks también funcionan con eventos de envío (no solo de recepción). Tú defines la estructura de la URL usando variables como {{phone}}, {{message}}, etc.
Las respuestas automáticas envían un mensaje de vuelta cuando se recibe un mensaje que contiene una palabra clave específica. Puedes configurar la palabra clave, el mensaje de respuesta y el dispositivo que lo envía.
Al configurar la URL de un hook, puedes usar estas variables que se reemplazan automáticamente con los datos del evento:
| Variable | Descripción |
|---|---|
{{phone}} | Número de teléfono del remitente/destinatario |
{{message}} | Contenido del mensaje |
{{device}} | ID del dispositivo |
{{sim}} | Ranura de la tarjeta SIM (1 o 2) |
{{date.timestamp}} | Fecha/hora del evento en formato timestamp |
{{date.time}} | Fecha/hora legible del evento |
Las imágenes a continuación muestran el flujo de funcionamiento de los hooks y las respuestas automáticas:
Cuando un hook se activa, el sistema hace una solicitud GET a tu URL. Tu servidor recibe los datos como parámetros en la URL:
<?php
// Tu servidor recibe los datos del hook via GET
$telefono = $_GET["phone"] ?? ""; // Número de teléfono
$mensaje = $_GET["message"] ?? ""; // Contenido del mensaje
$device = $_GET["device"] ?? ""; // ID del dispositivo
$sim = $_GET["sim"] ?? ""; // Ranura SIM (1 o 2)
$timestamp = $_GET["timestamp"] ?? "";// Fecha/hora del evento
// Ejemplo: guardar en base de datos
$pdo = new PDO("mysql:host=localhost;dbname=miapp", "usuario", "clave");
$stmt = $pdo->prepare("INSERT INTO mensajes (telefono, mensaje, fecha) VALUES (?, ?, ?)");
$stmt->execute([$telefono, $mensaje, $timestamp]);
// Ejemplo: enviar notificación
mail("admin@miempresa.com", "Nuevo mensaje de $telefono", $mensaje);
echo "OK";