Ejemplos de Cliente API de Onurix con Python

Este repositorio contiene ejemplos de código en Python para interactuar con la API de Onurix. Está diseñado para ayudarte a integrar fácilmente los servicios de Onurix (SMS, Llamadas, WhatsApp, etc.) en tus aplicaciones o scripts de Python.

📋 Tabla de Contenido

• Ejemplos de Cliente API de Onurix con Python
  • 📋 Tabla de Contenido
  • ⚙️ Prerrequisitos
  • 📂 Estructura del Repositorio
    • Calls
    • General
    • Groups and Contacts
    • SMS
    • URL
    • WhatsApp
  • 📖 Uso
  • ⚙️ Configuración de Parámetros
    • Credenciales de Autenticación (Obligatorias) POST o GET
    • Parámetros Comunes
    • Parámetros Específicos
    • Ejemplo de parámetros para SMS/SendSMS.py
    • Ejemplo de parámetros para WhatsApp\SendWhatsApp2FA.py
  • 📚 Documentación Completa de la API
  • 📄 Licencia
  • 📞 Soporte

⚙️ Prerrequisitos

Antes de empezar, asegúrate de tener instalado lo siguiente:

• Python 3.8+
• La librería requests de Python. Puedes instalarla con pip install requests.

📂 Estructura del Repositorio

Los ejemplos de código están organizados en carpetas que corresponden a las diferentes categorías de la API de Onurix. Las peticiones a la API se realizan comúnmente mediante HTTP POST o GET. Para los envíos de WhatsApp, es necesario enviar los datos en formato JSON.

A continuación, se detalla cada endpoint de ejemplo y el método HTTP que utiliza:

Calls

Archivo	Método	Descripción
SendCall.py	POST	Genera una llamada con un mensaje de voz.
SendCALL2FA.py	POST	Genera y entrega un código de verificación 2FA a través de una llamada.

General

Archivo	Método	Descripción
Balance.py	GET	Consulta el saldo de créditos de la cuenta.
Security.py	POST	Bloquea un número de teléfono para no recibir comunicaciones.
VerificationCode2FA.py	POST	Realiza la verificación de un código 2FA.
VerificationMessage.py	GET	Verifica el estado de un envío de SMS o llamada.

Groups and Contacts

Archivo	Método	Descripción
AssociateContactToGroup.py	POST	Asocia un contacto a un grupo.
ContactCreate.py	POST	Crea un nuevo contacto.
ContactDelete.py	POST	Elimina un contacto.
ContactGroupList.py	GET	Lista los contactos de un grupo.
ContactUpdate.py	POST	Actualiza la información de un contacto.
DissasociateContactToGroup.py	POST	Desasocia un contacto de un grupo.
GroupCreate.py	POST	Crea un nuevo grupo de contactos.
GroupDelete.py	POST	Elimina un grupo de contactos.
GroupList.py	GET	Lista todos los grupos de la cuenta.
GroupUpdate.py	POST	Actualiza el nombre de un grupo.

SMS

Archivo	Método	Descripción
SendSMS.py	POST	Envía un mensaje de texto (SMS).
SendSMS2FA.py	POST	Envía un mensaje de texto (SMS) con un código de verificación 2FA.

URL

Archivo	Método	Descripción
Statistics.py	GET	Obtiene las estadísticas de una URL corta.
URLShortener.py	POST	Crea una URL corta.

WhatsApp

Archivo	Método	Descripción
SendWhatsApp2FA.py	POST (JSON)	Envía un mensaje de WhatsApp con un código de verificación 2FA.
WhatsAppGeneralSend.py	POST (JSON)	Envía un mensaje de WhatsApp usando una plantilla.

📖 Uso

1. Clona el repositorio:

   git clone https://github.com/onurixlatam/onurix-python.git
   cd onurix-python

2. Instala las dependencias necesarias:

   pip install -r requirements.txt

3. Navega al archivo del endpoint que deseas utilizar (ej. SMS/SendSMS.py).

4. Edita el archivo y reemplaza los valores de los placeholders como se explica en la sección de Configuración de Parámetros.

5. Ejecuta el script desde tu terminal:

   python SMS/SendSMS.py

6. Verifica la respuesta que se imprimirá en la consola.

⚙️ Configuración de Parámetros

Para usar los ejemplos, necesitas reemplazar los valores de los placeholders (AQUI_...) con tus datos reales. A continuación, se detallan los parámetros que encontrarás en los scripts:

Credenciales de Autenticación (Obligatorias) POST o GET

Parámetro	Descripción
client	Tu ID de Cliente. Lo encuentras en tu panel de Onurix en Seguridad API.
key	Tu Llave de API. La encuentras en tu panel de Onurix en Seguridad API.

Parámetros Comunes

Parámetro	Descripción	Ejemplo
phone	Número de teléfono de destino. Para múltiples números, sepáralos por comas.	573001234567 o 573001234567,573001234568
name	Nombre para un contacto o grupo.	Mi Grupo
lastname	Apellido para un contacto.	Pérez
email	Correo electrónico de un contacto.	[email protected]
id	ID de un recurso (mensaje, contacto, grupo).	12345
group-id	ID de un grupo.	6789
groups	IDs de grupos separados por comas.	1,2,3
app-name	Nombre de la aplicación 2FA creada en Onurix.	MiApp

Parámetros Específicos

Servicio	Parámetro	Descripción
SMS	sms	Contenido del mensaje de texto a enviar.
Llamadas	message	Mensaje que se reproducirá en la llamada.
Llamadas	voice	Voz a usar en la llamada (ej. Mariana, Penelope).
Llamadas	audio-code	ID de un audio previamente cargado en la plataforma.
URL	url-long	La URL original que deseas acortar.
URL	alias	(Opcional) Alias personalizado para la URL corta.
WhatsApp	templateId	ID de la plantilla de WhatsApp aprobada por Meta.
WhatsApp	data	Un objeto JSON con los valores para la plantilla.

Ejemplo de parámetros para SMS/SendSMS.py

payload={
  'client': '1',
  'key': '********************',
  'phone': '30012345678',
  'sms': 'Este es un mensaje de prueba del API de Onurix.com'
}

Ejemplo de parámetros para WhatsApp\SendWhatsApp2FA.py

payload = json.dumps({
  "phones": "30012345678",
  "header": {
    "1": {
      "type": "image",
      "value": {
        "link": "https://tudominio.com/archivo-video.mp4"
      }
    }
  },
  "body": {
    "1": {
      "type": "text",
      "value": ""
    },
    "2": {
      "type": "text",
      "value": ""
    }
  },
  "button": {}
})

📚 Documentación Completa de la API

Para obtener una descripción detallada de todos los endpoints, parámetros y respuestas de la API, por favor consulta nuestra documentación oficial en https://docs.onurix.com/.

📄 Licencia

Este proyecto está bajo la Licencia MIT.

📞 Soporte

Para soporte y preguntas, no dudes en contactarnos:

• Email: [email protected]
• Website: https://onurix.com