📱 toDus-API

Cliente Python para ToDus — la plataforma de mensajería instantánea cubana.

📖 LEER LA DOCUMENTACIÓN COMPLETA AQUÍ 📖

---

⚡ ¿Qué es toDus-API?

Es una librería moderna, síncrona y orientada a eventos para interactuar con la red de ToDus. Te permite crear bots interactivos, manejar grupos y canales, enviar contenido multimedia, publicar historias y mucho más, todo usando Python puro.

Cobertura del protocolo: 100% de las funciones de la app oficial (inspeccionada desde el código fuente Android).

---

📦 Instalación

pip install todus-API

---

🚀 Uso Rápido (Tu primer bot)

from todus import ToDusClient2

# 1. Configura tus credenciales
client = ToDusClient2("5350000000", password="tu_password")
client.login()

# 2. Crea un callback para los mensajes
def responder_mensajes(msg):
    if msg.get("body"):
        print(f"Recibido: {msg['body']}")
        client.send_message(msg['from'], f"¡Hola! Recibí: {msg['body']}")

# 3. Empieza a escuchar
print("Bot en ejecución...")
client.listen_messages(responder_mensajes)

---

📚 Documentación y Recursos

Toda la información detallada sobre autenticación, subida de archivos, historias, canales, grupos, bloqueos y más la encontrarás en nuestro sitio web oficial de documentación:

👉 https://eljoker63.github.io/toDus-API

• ToDus oficial: ToDus Web
• PyPI: toDus-API
• Changelog: CHANGELOG.md
• Contribuir: CONTRIBUTING.md

---

Desarrollado con ❤️ por ElJoker63.