Recupera e retorna uma lista formatada de
grupos do WhatsApp disponíveis.
Esta ferramenta permite ao agente obter os
grupos cadastrados, exibindo
informações relevantes como o ID do grupo e
seu nome, em formato textual.
A resposta pode ser usada para seleção
posterior de um grupo para envio
de mensagens.
Returns:
    str: Lista de grupos no formato:
    "Grupo ID: <id>, Nome: <nome>

"

Recupera as mensagens enviadas em um grupo do WhatsApp dentro de um intervalo de datas especificado. Esta ferramenta permite ao agente acessar o histórico de conversas de um grupo, retornando as mensagens publicadas entre 'start_date' e 'end_date', com detalhes como remetente, horário, tipo da mensagem e conteúdo textual. Args: group_id (str): Identificador único do grupo do WhatsApp. start_date (str): Data e hora de início no formato 'YYYY-MM-DD HH:MM:SS'. end_date (str): Data e hora de término no formato 'YYYY-MM-DD HH:MM:SS'. Returns: str: Lista de mensagens formatadas, com os campos: - Usuário - Data e hora - Tipo da mensagem - Texto Cada mensagem é separada por um delimitador visual.

Envia uma mensagem de texto para um grupo específico do WhatsApp. Esta ferramenta permite ao agente enviar mensagens para grupos do WhatsApp utilizando a API do WhatsApp. A mensagem será entregue ao grupo identificado pelo group_id fornecido. Args: group_id (str): Identificador único do grupo do WhatsApp no formato 'XXXXXXXXXXXXXXXXX@g.us'. Este ID pode ser obtido através da ferramenta get_groups(). message (str): Conteúdo da mensagem a ser enviada. Pode conter texto formatado, emojis e quebras de linha. Returns: str: Mensagem indicando o resultado da operação: - "Mensagem enviada com sucesso" em caso de êxito - "Erro ao enviar mensagem: <descrição>" em caso de falha Raises: Exception: Possíveis erros durante o envio da mensagem, como: - Grupo não encontrado - Problemas de conexão - Falha na autenticação - Formato inválido de mensagem

Envia uma mensagem de texto para um número de telefone específico via WhatsApp. Esta ferramenta permite ao agente enviar mensagens diretamente para números de telefone individuais utilizando a API do WhatsApp. A mensagem será entregue ao destinatário somente se o número estiver registrado no WhatsApp. Args: cellphone (str): Número do telefone no formato internacional, incluindo código do país e DDD, sem caracteres especiais. se por acaso falta o 55, coloque 55 coloque o 55 na frente do numero. Mas o usuário tem que informa o DDD obrigatoriamente. Exemplo: '5511999999999' para um nú mero de São Paulo, Brasil. message (str): Conteúdo da mensagem a ser enviada. Pode conter texto formatado, emojis e quebras de linha. Returns: str: Mensagem indicando o resultado da operação: - "Mensagem enviada com sucesso" em caso de êxito - "Erro ao enviar mensagem: <descrição>" em caso de falha Raises: Exception: Possíveis erros durante o envio da mensagem, como: - Número inválido ou mal formatado - Número não registrado no WhatsApp - Problemas de conexão - Falha na autenticação - Formato inválido de mensagem