elysium-api 1.1.0

API moderna e futurista para integração com o sistema Elysium

Elysium API - Python

API moderna e futurista para integração com o sistema Elysium.

Instalação

pip install elysium-api

Configuração Inicial

from elysium_api import ElysiumApi

# Inicialização da API
api = ElysiumApi({
    "email": "[e-mail]",
    "hash": "seu-hash-de-autenticacao"
})

Gerenciamento de Clientes

Criar Cliente

# Exemplo de criação de cliente
cliente = api.create_client({
    "nome": "Fernando",
    "numero": "5532999999999",
    "plano_id": "264",
    "email_cliente": "[e-mail]",
    "vencimento": "2025-10-31",
    "observacao": "Observação opcional"
})

Atualizar Cliente

# Atualização mínima
atualizacao = api.update_client({
    "identificador_tipo": "numero",
    "identificador_valor": "5532999999999",
    "vencimento": "2025-10-31",
    "plano_id": "265"
})

# Atualização completa
atualizacao_completa = api.update_client({
    "identificador_tipo": "numero",
    "identificador_valor": "5532999999999",
    "nome": "Fernando Silva",
    "email_cliente": "[e-mail]",
    "vencimento": "2025-10-31",
    "plano_id": "265",
    "observacao": "Nova observação"
})

Deletar Cliente

# Deletar por número
delete_numero = api.delete_client({
    "identificador_tipo": "numero",
    "identificador_valor": "5532999999999"
})

# Deletar por email
delete_email = api.delete_client({
    "identificador_tipo": "email",
    "identificador_valor": "[e-mail]"
})

Listar Clientes

# Listar todos os clientes
clientes = api.list_clients()

# Listar com filtros
clientes_filtrados = api.list_clients(
    status="active",
    search="Fernando",
    page=1,
    limit=10
)

Mensagens

Enviar Mensagem Individual

# Enviar mensagem de texto
mensagem = api.send_single_message({
    "numero": "5532999999999",
    "mensagem": "Olá! Esta é uma mensagem de teste."
})

# Enviar imagem
mensagem_imagem = api.send_single_message({
    "numero": "5532999999999",
    "mensagem": "Veja esta imagem!",
    "midia": "https://exemplo.com/imagem.jpg"
})

Enviar Mensagem para Plano

mensagem_plano = api.send_message_plan({
    "plano_id": "264",
    "mensagem": "Mensagem para todos os clientes do plano!"
})

Planos

Criar Plano

plano = api.create_plan({
    "nome": "Plano Premium",
    "valor": 100,
    "duracao": 30,
    "hora_disparo": "00:00"
})

Atualizar Plano

plano_atualizado = api.update_plan("266", {
    "nome": "Plano Premium 2.0",
    "valor": 100,
    "duracao": 30,
    "hora_disparo": "00:00"
})

Listar Planos

# Listar todos os planos
planos = api.list_plans()

# Listar com filtros
planos_filtrados = api.list_plans(
    search="premium",
    page=1,
    limit=10
)

Tratamento de Erros

A biblioteca utiliza exceções Python para tratamento de erros. Sempre utilize try/except:

try:
    resultado = api.create_client({...})
except Exception as error:
    print("Erro:", error)

Documentação Completa

Para mais detalhes sobre os parâmetros e retornos de cada método, consulte a documentação completa em nossa página oficial.

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.