Consulta o status de entrega de uma mensagem enviada pelo I-Bot.

Verifica o status do registro de um chat no I-Bot. Retorna: pending, fetched, done ou error. Quando done, inclui link do chat.

Busca um contato existente no I-Bot pelo número de telefone. Usa a API interna do painel (sem navegador, <1s) e cai no Playwright se ela falhar. Tenta múltiplos formatos de número e cobre chats ativos e arquivados. Aceita filtro por aparelho (padrão: IBOT_DEVICE, ou todos) — o mesmo número pode existir em outro aparelho com conversa diferente. Retorna chat_id e link direto. NÃO envia mensagem. Requer a sessão do painel (rode ibot-mcp login primeiro).

Busca múltiplos contatos no I-Bot de uma vez. Usa a API interna do painel (sem navegador, ~1s por contato) e cai no Playwright se ela falhar. Aceita filtro por aparelho (padrão: IBOT_DEVICE, ou todos). Retorna lista com chat_id e link para cada contato encontrado.

Lê o histórico de mensagens de um chat no I-Bot, incluindo as ANOTAÇÕES internas na mesma linha do tempo. Usa a API interna do painel (sem navegador, ~250ms) e cai no Playwright se ela falhar. O histórico completo é acessível: aumente o limit e a resposta avisa quando ainda há mensagem mais antiga. Requer session.json (execute login.js primeiro).

Baixa mídia (áudio/imagem/vídeo/documento) das mensagens do I-Bot para o disco local. Passe as URLs do campo arquivo.url que ibot_read_messages retorna. Não requer sessão nem login: o S3 do painel exige apenas o header Referer (medido 29/08/2026). Se a URL registrada falhar, tenta as pastas alternativas do bucket (received/sent/attached/unattached). Retorna caminho e tamanho de cada arquivo salvo.

Lista e filtra chats do painel I-Bot. Usa a API interna do painel (sem navegador, ~1s; 250 chats em 1,8s) e cai no Playwright se ela falhar. Filtra por APARELHO (padrão: IBOT_DEVICE; vazio = todos), status, não lidas, arquivados, favoritos, tag, nome e número. Retorna nome, status, tags, aparelho, última mensagem, timestamp e não lidas. O retorno SEMPRE diz qual corte ocorreu (fim real da lista / teto do painel / limite pedido) — nunca corta em silêncio. TETO: a API interna PAGINA (medido 17/08/2026: 250 chats distintos numa consulta), mas o Playwright de fallback trava em 100 POR CONSULTA sem paginação (medido 14/08/2026: nenhum limit/offset traz o chat 101) — se o retorno avisar teto do painel, varrer além exige FATIAR por filtro e cruzar wa_chat_id. FORÇA DOS EIXOS, medida em produção: device é o mais forte (cada aparelho é uma janela própria; único jeito de isolar o inbound de UM número) > department (que é TAG, uma janela por tag) > status × order_by, que satura rápido — cruzar 6 status × 8 ordenações bate o teto em quase toda fatia e deixa um MIOLO inalcançável. Três armadilhas medidas: (1) whatsapp_number dá FALSO NEGATIVO — o chat existe, wa_chat_id igual ao buscado, e a busca volta vazia; a causa é o filtro de arquivados ser EXCLUSIVO (numa conta madura quase todo o histórico está arquivado), e leads já foram dados como 'sem chat' tendo chat ABERTO. Pela API interna isso está resolvido (busca por número que não acha nada refaz o pass entre arquivados e avisa), mas no fallback Playwright a armadilha continua: nunca conclua 'não tem chat' sem repetir com archived=true; (2) a ordenação padrão é por última mensagem, que AFUNDA o chat sem resposta (a última mensagem é a do cliente, antiga) — para caçar conversa parada sem dono use '-created', e para achar quem nem isso alcança use 'updated' (ascendente), que foi o que revelou leads invisíveis a 4 ciclos de varredura; (3) o nome do contato aqui é o do WhatsApp, não o do CRM ('.', '', nome de empresa) — buscar pelo nome que está no CRM dá falso negativo. SEMPRE rode um controle positivo (um chat de estado já conhecido) na mesma virada: sem ele não há como distinguir 'não existe' de 'a fatia não alcança'.

Lê os campos personalizados de um chat no I-Bot (Empresa, Email, CRM, etc). Usa a API interna do painel — não abre navegador. Latência: <1s. Requer session.json (execute login.js primeiro).

Lê as tags aplicadas a um chat no I-Bot. Usa a API interna do painel — não abre navegador. Latência: <1s. Requer session.json.