🚀 Big News: Socket Acquires Coana to Bring Reachability Analysis to Every Appsec Team.Learn more

whats77

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

whats77

Facilitador para uso da API WhatsApp (ZAPI)

0.1.1
Maintainers
1

Whats77

Versão: 0.1.1

Whats77 é um facilitador para o uso da API WhatsApp (ZAPI). Este pacote abstrai a autenticação e diversas ações da API, como envio de mensagens de texto, áudio e documentos.

Instalação

Antes de instalar, assegure-se de ter o Python 3.8 ou superior instalado.

Instale o pacote diretamente via pip:

pip install whats77

Configuração

O Whats77 utiliza variáveis de ambiente para configurar a autenticação. Crie um arquivo .env na raiz do seu projeto com o seguinte formato:

INSTANCE_ID=seu_instance_id
TOKEN=seu_token
SECURITY_TOKEN=seu_security_token

Uso

Inicialização da Classe

A classe Whats77 é responsável por gerenciar a autenticação e as ações. As credenciais podem ser fornecidas diretamente ou carregadas do arquivo .env.

from whats77 import Whats77

# Inicializa a classe com credenciais carregadas do .env
whatsapp = Whats77()

Envio de Mensagens

Enviar mensagem de texto

# Envia uma mensagem de texto
whatsapp.send_text(
    phone_number="+5511999999999",
    message="Olá, isso é um teste!"
)

Enviar documento

whatsapp.send_document(
    phone_number="+5511999999999",
    file_path="/caminho/para/arquivo.pdf",
    document_type="pdf",
    caption="Segue o relatório em anexo."
)

Enviar áudio

# Converte o arquivo de áudio para Base64
base64_audio = Whats77.parse_to_base64("/caminho/para/audio.mp3")

# Envia o áudio
whatsapp.send_audio(
    phone_number="+5511999999999",
    base64_audio=base64_audio
)

Normalização e Validação de Números

A classe Whats77 fornece métodos utilitários para trabalhar com números de telefone.

Normalizar número de telefone

normalized_number = Whats77.normalize_phone_number("11999999999")
print(normalized_number)  # Saída: 5511999999999

Validar número de WhatsApp

is_valid = Whats77.is_valid_whatsapp_number("5511999999999")
print(is_valid)  # Saída: True

Dependências

  • requests>=2.0.0
  • python-dotenv>=0.21.0

Certifique-se de instalar as dependências via pip se ainda não estiverem presentes no seu ambiente.

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts