Documentación para Desarrolladores

Integra NotificaYA en minutos. Encuentra aquí todos los ejemplos de código y guías que necesitas para conectar tus plataformas favoritas con WhatsApp y Telegram.

Domótica y Smart Home

Con NotificaYA, tu casa te hablará directamente. Recibe alertas instantáneas en WhatsApp cuando se abra una puerta, se detecte movimiento, o termine la lavadora.

Home Assistant
OpenHAB
Domoticz
ESP8266 / ESP32

Home Assistant

Usa el servicio `rest_command` para integrar NotificaYA. Añade esto a tu `configuration.yaml`:

# configuration.yaml
rest_command:
  notificaya_whatsapp:
    url: "http://gruposervimania.com/crm/sms/api.php"
    method: POST
    headers: { Content-Type: 'application/json' }
    payload: '{"apikey": "TU_API_KEY_AQUI", "servicio": "whatsapp", "numero": "{{ numero }}", "texto": "{{ texto }}"}'

Y luego, en tus automatizaciones, llama al servicio:

# automations.yaml
action:
  - service: rest_command.notificaya_whatsapp
    data:
      numero: "34612345678"
      texto: "🚨 ¡Alerta! Se ha detectado movimiento en el garaje."

OpenHAB

En tus reglas de OpenHAB, utiliza la acción `sendHttpPostRequest`:

// dentro de una regla .rules
var payload = '{"apikey": "TU_API_KEY_AQUI", "servicio": "whatsapp", "numero": "34612345678", "texto": "¡Alerta desde OpenHAB!"}'
sendHttpPostRequest("http://gruposervimania.com/crm/sms/api.php", "application/json", payload)

Domoticz

La forma más sencilla es usar un script de Lua que se active por un evento:

-- Script LUA para Domoticz
commandArray = {}
    local apiKey = "TU_API_KEY_AQUI"
    local numero = "34612345678"
    local texto = "Ha terminado la lavadora."
    local url = "http://gruposervimania.com/crm/sms/api.php?apikey=" .. apiKey .. "&servicio=whatsapp&numero=" .. numero .. "&texto=" .. texto:gsub(' ','%%20')
    os.execute('curl "' .. url .. '"')
return commandArray

ESP8266 / ESP32 (Arduino)

Envía datos desde tus microcontroladores de forma sencilla:

#include <WiFi.h>
#include <HTTPClient.h>
void setup() {
  WiFi.begin("TU_WIFI", "TU_CONTRASENA");
  while (WiFi.status() != WL_CONNECTED) { delay(1000); }
  HTTPClient http;
  String texto = "La temperatura es de 25 grados.";
  String url = "http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=whatsapp&numero=34612345678&texto=" + texto;
  url.replace(" ", "%20");
  http.begin(url); http.GET(); http.end();
}
void loop() {}

Plataformas de Integración (Low-Code)

Conecta NotificaYA con cientos de otras aplicaciones sin escribir código.

IFTTT
Microsoft Power Automate

IFTTT

Usa el servicio "Webhooks" como acción (Then That) y configura el "Make a web request":

URL: http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=whatsapp&numero=34612345678&texto={{TextField}}
Method: GET

Microsoft Power Automate

Utiliza la acción "HTTP" con el método POST:

Método: POST
URI: http://gruposervimania.com/crm/sms/api.php
Cuerpo:
{ "apikey": "TU_API_KEY_AQUI", "servicio": "whatsapp", "numero": "34612345678", "texto": "Mensaje desde Flow." }

Programación y Scripts

Integra NotificaYA directamente en tu código. Nuestra API RESTful es compatible con cualquier lenguaje.

PHP
Python
Bash (cURL)

PHP

$apiKey = "TU_API_KEY_AQUI";
$numero = "34612345678";
$texto = "El proceso ha terminado.";
$url = "http://gruposervimania.com/crm/sms/api.php?apikey=".urlencode($apiKey)."&servicio=whatsapp&numero=".urlencode($numero)."&texto=".urlencode($texto);
$response = file_get_contents($url);

Python

Usando la librería `requests` (`pip install requests`).

import requests
params = {'apikey': 'TU_API_KEY_AQUI', 'servicio': 'whatsapp', 'numero': '34612345678', 'texto': 'Alerta!'}
requests.get('http://gruposervimania.com/crm/sms/api.php', params=params)

Bash (cURL)

Ideal para notificaciones desde la terminal.

curl "http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=whatsapp&numero=34612345678&texto=Servidor reiniciado"

Llamadas de Voz (TTS)

Nuestra función estrella. Envía notificaciones de voz que se reproducirán en el teléfono. Ideal para alertas críticas. Simplemente, añade el parámetro `&tipo=voz` a tus llamadas.

Home Assistant
IFTTT
PHP
Bash (cURL)

Home Assistant (Voz)

rest_command:
  notificaya_telegram_voz:
    url: "http://gruposervimania.com/crm/sms/api.php"
    method: POST
    payload: '{"apikey": "TU_API_KEY_AQUI", "servicio": "telegram", "tipo": "voz", "texto": "{{ texto }}"}'

IFTTT (Voz)

URL: http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=telegram&tipo=voz&texto={{TextField}}

PHP (Voz)

$texto_alerta = "Alerta de seguridad: Límite de CPU superado.";
$url = "http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=telegram&tipo=voz&texto=".urlencode($texto_alerta);
$response = file_get_contents($url);

Bash (cURL) (Voz)

curl -d '{"apikey": "TU_API_KEY_AQUI", "servicio": "telegram", "tipo": "voz", "texto": "El servidor tiene poca memoria."}' \
-H "Content-Type: application/json" -X POST http://gruposervimania.com/crm/sms/api.php

Mensajes de Texto

Envía mensajes de texto tradicionales. La configuración es más sencilla, ya que tu Chat ID se obtiene de tu perfil.

Home Assistant
OpenHAB
Domoticz
ESP8266/ESP32
IFTTT
MS Power Automate
PHP
Python
Bash (cURL)

Home Assistant (Texto)

rest_command:
  notificaya_telegram_texto:
    url: "http://gruposervimania.com/crm/sms/api.php"
    method: POST
    payload: '{"apikey": "TU_API_KEY_AQUI", "servicio": "telegram", "texto": "{{ texto }}"}'

OpenHAB (Texto)

var payload = '{"apikey": "TU_API_KEY_AQUI", "servicio": "telegram", "texto": "Alerta desde OpenHAB!"}'
sendHttpPostRequest("http://gruposervimania.com/crm/sms/api.php", "application/json", payload)

Domoticz (Texto)

local texto = "Ha terminado la lavadora."
local url = "http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=telegram&texto=" .. texto:gsub(' ','%%20')
os.execute('curl "' .. url .. '"')

ESP8266 / ESP32 (Texto)

String texto = "Humedad de la planta baja.";
String url = "http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=telegram&texto=" + texto;
/* ... (resto del código WiFi y http) ... */

IFTTT (Texto)

URL: http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=telegram&texto={{TextField}}

Microsoft Power Automate (Texto)

Cuerpo:
{ "apikey": "TU_API_KEY_AQUI", "servicio": "telegram", "texto": "Tarea completada en Planner." }

PHP (Texto)

$texto = "Nuevo usuario registrado: juan@email.com";
$url = "http://gruposervimania.com/crm/sms/api.php?apikey=TU_API_KEY_AQUI&servicio=telegram&texto=".urlencode($texto);
$response = file_get_contents($url);

Python (Texto)

import requests
params = { 'apikey': 'TU_API_KEY_AQUI', 'servicio': 'telegram', 'texto': 'Alerta desde Python!' }
requests.get('http://gruposervimania.com/crm/sms/api.php', params=params)

Bash (cURL) (Texto)

curl -d '{"apikey": "TU_API_KEY_AQUI", "servicio": "telegram", "texto": "Poca memoria."}' \
-H "Content-Type: application/json" -X POST http://gruposervimania.com/crm/sms/api.php