Recibir mensajes
Puedes recibir automáticamente los mensajes y respuestas que lleguen al número de WhatsApp conectado a tu servicio de Flash Telecom mediante un webhook.
Una vez configurado, cada mensaje entrante se enviará a la dirección de tu servidor mediante una petición HTTP POST con los datos en formato JSON. No necesitas consultar periódicamente la API.
1. Configurar la recepción
- Prepara una dirección HTTPS pública en tu servidor que pueda recibir peticiones POST. Por ejemplo:https://midominio.es/whatsapp/webhook.php
- Solicita a Flash Telecom que asocie esa dirección al número de WhatsApp y a la clave API (wp_apikey) de tu servicio.
- Cuando se haya activado, los mensajes recibidos en ese número se enviarán automáticamente a tu webhook.
2. Formato del mensaje recibido
Ejemplo del JSON que recibirá tu servidor:
Campo | Descripción |
|---|---|
type | Tipo de mensaje recibido; para un mensaje de texto, text. |
from | Número de teléfono del remitente, con prefijo internacional. |
from_name | Nombre del remitente, cuando está disponible. |
to | Número de WhatsApp asociado al servicio. |
file | Información sobre el archivo adjunto, si la recepción de archivos está habilitada. En el ejemplo aparece como la cadena "null". |
message | Contenido del mensaje recibido. |
Los números del ejemplo aparecen sin el signo +. Tenlo en cuenta si posteriormente utilizas el remitente para enviar una respuesta.
3. Ejemplo de recepción en PHP
Crea un archivo webhook.php en la ruta que hayas configurado:
El ejemplo muestra cómo leer los datos recibidos. Adapta el procesamiento a tu aplicación y protege la URL de recepción antes de utilizarla en producción.
4. Comprobar que funciona
- Para una prueba inicial puedes utilizar Webhook.site, que genera una URL temporal y muestra las peticiones recibidas. No lo utilices con conversaciones reales que contengan datos personales.
- Configura esa URL como webhook de prueba.
- Envía un WhatsApp desde otro teléfono al número conectado a Flash Telecom.
- Comprueba que llega una petición POST y que contiene el JSON con los datos del mensaje.
Cuando hayas terminado, sustituye la URL de prueba por la dirección definitiva de tu servidor.
5. Responder al mensaje
Puedes utilizar el número recibido en from para responder mediante la API de envío de Flash Telecom.
Endpoint de envío: https://api.flashtelecom.es/v1/wasend
Sustituye mi_apikey por tu clave API y recipient por el número al que quieras responder.
Para más información sobre el envío, consulta Enviar Mensaje.