SDK oficial da Vezor para integração com APIs de comunicação e CRM. Este pacote Python fornece interfaces simples e intuitivas para trabalhar com a EvoAPI e Kommo CRM.
pip install vezor-sdk- Python 3.8 ou superior
- requests >= 2.31.0
Cliente genérico para APIs da Vezor com funcionalidades básicas de autenticação e requisições.
Cliente especializado para integração com a EvoAPI, oferecendo métodos para gerenciar contatos, clientes e mensagens.
Cliente para integração com o Kommo CRM v4, permitindo gerenciar pipelines, status, tags e webhooks.
from vezor_sdk import VzrClient
# Inicializar cliente
client = VzrClient(
base_url="https://api.vezor.cloud",
api_key="sua_api_key_aqui"
)
# Teste de conexão
response = client.ping()
print(response)
# Buscar dados de um recurso
data = client.get_data("usuarios")
print(data)from vezor_sdk import EvoApiClient
# Inicializar cliente EvoAPI
evo_client = EvoApiClient(
base_url="https://evoapi.vezor.cloud",
instance="sua_instancia",
api_key="sua_api_key"
)
# Obter contatos
contatos = evo_client.get_contacts()
print(f"Total de contatos: {len(contatos)}")
# Obter contatos e salvar em arquivo
contatos = evo_client.get_contacts(save_path="contatos.json")
# Obter clientes com filtros
filtros = {"status": "ativo"}
clientes = evo_client.get_clients(filters=filtros)
# Obter todas as mensagens
mensagens = evo_client.get_messages(save_path="mensagens.json")
print(f"Total de mensagens: {len(mensagens)}")from vezor_sdk import KommoApiClient
# Inicializar cliente Kommo
kommo_client = KommoApiClient(
base_url="https://minhaempresa.kommo.com",
token="seu_token_oauth2"
)
# Obter pipelines
pipelines = kommo_client.get_pipelines()
for pipeline in pipelines:
print(f"Pipeline: {pipeline['name']} (ID: {pipeline['id']})")
# Obter status de um pipeline
statuses = kommo_client.get_pipeline_statuses(pipeline_id=12345)
# Gerenciar tags
tags = kommo_client.get_lead_tags()
nova_tag = kommo_client.create_lead_tag("Nova Tag", "FF0000")
# Gerenciar webhooks
webhooks = kommo_client.get_webhooks()
novo_webhook = kommo_client.create_webhook(
destination="https://meusite.com/webhook",
settings=["lead_add", "lead_update"]
)- API Key: Token Bearer para autenticação
- Base URL: URL base da API Vezor
- API Key: Chave de API específica da EvoAPI
- Instance: ID da instância
- Base URL: URL base da EvoAPI
- Token: Token OAuth2 do Kommo
- Base URL: URL da sua conta Kommo (ex: https://minhaempresa.kommo.com)
from vezor_sdk import EvoApiClient
evo_client = EvoApiClient(
base_url="https://evoapi.vezor.cloud",
instance="minha_instancia",
api_key="minha_api_key"
)
# Obter mensagens com paginação personalizada
mensagens = evo_client.get_messages(offset=5000)
# Filtrar mensagens por tipo
mensagens_texto = [msg for msg in mensagens if msg.get('type') == 'text']
print(f"Mensagens de texto: {len(mensagens_texto)}")from vezor_sdk import KommoApiClient
kommo_client = KommoApiClient(
base_url="https://minhaempresa.kommo.com",
token="meu_token"
)
# Obter informações completas do pipeline
pipelines = kommo_client.get_pipelines()
for pipeline in pipelines:
print(f"\n=== {pipeline['name']} ===")
statuses = kommo_client.get_pipeline_statuses(pipeline['id'])
for status in statuses:
print(f" - {status['name']}: {status['color']}")git clone https://github.com/vezor-group/vezor_sdk.git
cd vezor_sdk
pip install -e .python -m pytest tests/Veja o CHANGELOG.md para histórico de versões e mudanças.
Contribuições são bem-vindas! Por favor, leia nossas diretrizes de contribuição antes de enviar pull requests.
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add some AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - Abra um Pull Request
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.
- Email: admin.platform@vezor.com.br
- Documentação: GitHub Wiki
- Issues: GitHub Issues
Sobre a Vezor Technology
Somos uma empresa de tecnologia comprometida com o desenvolvimento democrático e acessível de soluções inovadoras. Acreditamos que a tecnologia deve ser uma ferramenta de transformação social, capaz de resolver problemas reais e criar oportunidades equitativas para todos.
Nossa missão é democratizar o acesso a tecnologias avançadas, desenvolvendo soluções que sejam simples de usar, economicamente acessíveis e tecnicamente robustas. Trabalhamos com Inteligência Artificial, integrações de sistemas, plataformas web e mobile, sempre priorizando a inclusão digital e o impacto social positivo.
Apoiamos o desenvolvimento de ecossistemas tecnológicos abertos e colaborativos, onde desenvolvedores, empresas e comunidades possam crescer juntos. Nossas ferramentas e SDKs são criados para facilitar a adoção de tecnologias emergentes, reduzindo barreiras técnicas e econômicas.
Conheça nosso Manifesto: https://about.vezor.cloud/
Desenvolvido pela equipe Vezor LABs