{"_id":"@aeternis/whatsapp-export","_rev":"2-842f3d7c835afa4a5dd7791211c233dd","name":"@aeternis/whatsapp-export","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aeternis/whatsapp-export","version":"1.0.0","keywords":["whatsapp","baileys","export","contacts","csv","vcard","json","cli"],"author":{"name":"Aeternis Sistemas"},"license":"MIT","_id":"@aeternis/whatsapp-export@1.0.0","maintainers":[{"name":"aeternis","email":"contato@aeternis.com.br"}],"homepage":"https://aeternis.com.br","bin":{"aeternis-whatsapp-export":"bin/aeternis-whatsapp-export"},"dist":{"shasum":"eff86f5c30a3832270b6bf9c4763ebcc5871d814","tarball":"https://registry.npmjs.org/@aeternis/whatsapp-export/-/whatsapp-export-1.0.0.tgz","fileCount":10,"integrity":"sha512-j73IypYrMkUq/YaXcCyFFKZD1FQ+gpJqEjZzjcc9VZfjY4h4ujoCxmYJXal5y9a/TXlkBlHSKtIfiI4yJu2xAQ==","signatures":[{"sig":"MEUCIQDuLVLhsijEa5/k3SPcqsmT4Fclofp4aTSqlxU2jx4tdAIgDnUyQ0c4GO0MHdIVP34lkGD8EvGpw7cLnfSbqViQx/Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23688},"type":"module","engines":{"node":">=18"},"exports":{".":"./src/index.js"},"scripts":{"start":"node ./src/cli.js"},"_npmUser":{"name":"aeternis","email":"contato@aeternis.com.br"},"_npmVersion":"11.16.0","description":"Exporte os contatos do WhatsApp (contatos salvos e membros de grupos) com nome e telefone para CSV, vCard ou JSON, usando o protocolo multi-device (Baileys).","directories":{},"_nodeVersion":"24.18.0","dependencies":{"pino":"^9.0.0","qrcode-terminal":"^0.12.0","@whiskeysockets/baileys":"^6.7.24"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/whatsapp-export_1.0.0_1788740600797_0.8781966474933938","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aeternis/whatsapp-export","version":"1.0.1","description":"Exporte os contatos do WhatsApp (contatos salvos e membros de grupos) com nome e telefone para CSV, vCard ou JSON, usando o protocolo multi-device (Baileys).","author":{"name":"Aeternis Sistemas"},"homepage":"https://aeternis.com.br","type":"module","bin":{"aeternis-whatsapp-export":"bin/aeternis-whatsapp-export"},"exports":{".":"./src/index.js"},"engines":{"node":">=18"},"scripts":{"start":"node ./src/cli.js"},"keywords":["whatsapp","baileys","export","contacts","csv","vcard","json","cli"],"license":"MIT","dependencies":{"@whiskeysockets/baileys":"^6.7.24","pino":"^9.0.0","qrcode-terminal":"^0.12.0"},"_id":"@aeternis/whatsapp-export@1.0.1","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-gcIZUsJ5rsG5lEh3j6v6C60nrf12g7VvXHIYvRdnSqdxyk8lNiiNqVEJ/YZLvgPKUZa6YboJb7txzxlKsU96eg==","shasum":"384ea0e8da89f7e07da181be2d9287889c541e44","tarball":"https://registry.npmjs.org/@aeternis/whatsapp-export/-/whatsapp-export-1.0.1.tgz","fileCount":9,"unpackedSize":23855,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHx/dnK6DKhUaUjJOswHY4F6CMkM54m8GmQtcxVa8FgSAiBBrwiBb5pqplO1KMsuacUgGAWrDqMMyhONGjW1dCKNcw=="}]},"_npmUser":{"name":"aeternis","email":"contato@aeternis.com.br"},"directories":{},"maintainers":[{"name":"aeternis","email":"contato@aeternis.com.br"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/whatsapp-export_1.0.1_1788743443326_0.28321426295352126"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-07T00:23:20.629Z","modified":"2026-09-07T01:10:43.623Z","1.0.0":"2026-09-07T00:23:20.928Z","1.0.1":"2026-09-07T01:10:43.461Z"},"author":{"name":"Aeternis Sistemas"},"license":"MIT","homepage":"https://aeternis.com.br","keywords":["whatsapp","baileys","export","contacts","csv","vcard","json","cli"],"description":"Exporte os contatos do WhatsApp (contatos salvos e membros de grupos) com nome e telefone para CSV, vCard ou JSON, usando o protocolo multi-device (Baileys).","maintainers":[{"name":"aeternis","email":"contato@aeternis.com.br"}],"readme":"# @aeternis/whatsapp-export\n\nCLI + biblioteca Node que exporta contatos do WhatsApp (contatos salvos e/ou\nmembros de grupos) para **CSV**, **vCard (.vcf)** ou **JSON**, usando o\nprotocolo multi-device via [Baileys](https://github.com/WhiskeySockets/Baileys)\n(`@whiskeysockets/baileys`, v6.7.x).\n\nFeito por [Aeternis Sistemas](https://aeternis.com.br).\n\n## Instalação\n\nRequisitos: **Node.js >= 18**.\n\n```bash\nnpm install --global @aeternis/whatsapp-export\n```\n\nDepois disso, o comando `aeternis-whatsapp-export` fica disponível no terminal.\n\nPara usar como **biblioteca** num projeto (sem instalar global):\n\n```bash\nnpm install @aeternis/whatsapp-export\n```\n\n## Uso\n\nNa primeira execução, um **QR code** é exibido no terminal. Escaneie com o\nWhatsApp do celular (Configurações → Aparelhos conectados → Conectar aparelho).\nAs credenciais ficam salvas na pasta `./auth/` e as próximas execuções não\npedem QR novamente.\n\n```bash\n# Todos os contatos salvos\naeternis-whatsapp-export contacts\naeternis-whatsapp-export contacts --format vcard --out contatos.vcf\naeternis-whatsapp-export contacts --format json --out contatos.json\n\n# Listar grupos dos quais você participa\naeternis-whatsapp-export groups\n\n# Membros de um grupo (use o <id> retornado por \"groups\")\naeternis-whatsapp-export group \"5511987654321@g.us\" --format csv --out membros.csv\n```\n\n### Flags\n\n| Flag                 | Descrição                                                          |\n| -------------------- | ------------------------------------------------------------------ |\n| `--format <fmt>`     | `csv` (padrão), `vcard` ou `json`.                                 |\n| `--out <arquivo>`    | Grava em um arquivo. Sem essa flag, escreve no `stdout`.           |\n| `-h`, `--help`       | Mostra a ajuda.                                                    |\n\n## API da biblioteca\n\n```js\nimport { exportContacts, listGroups, exportGroup } from '@aeternis/whatsapp-export';\n```\n\n- `exportContacts()` → `[{ name, number }]` (todos os contatos salvos).\n- `listGroups()` → `[{ id, name }]` (grupos dos quais você participa).\n- `exportGroup(id)` → `[{ name, number }]` (membros de um grupo).\n\n## Limitação sobre os nomes\n\nO **telefone** é sempre exportado. Já o **nome** depende do que o WhatsApp\ndisponibiliza para o cliente web: o protocolo multi-device **não envia o nome\nque você salvou na agenda do celular** — apenas o apelido que a pessoa definiu\nno perfil (`notify`) e o nome de empresa (`verifiedName`). Por isso, contatos\ncom quem você **já trocou mensagem** normalmente vêm com nome (via nome da\nconversa), mas contatos que nunca te mandaram mensagem podem vir **sem nome**.\n\n## ⚠️ Riscos de banimento\n\nEste projeto usa o **protocolo não-oficial** do WhatsApp. O uso automatizado\npode violar os Termos de Serviço do WhatsApp e **sua conta pode ser banida**.\n\n- Use **apenas para ler/exportar os seus próprios contatos**.\n- Evite disparar múltiplas conexões em sequência.\n- Trate a pasta `./auth/` como uma **chave privada**: ela dá acesso à sua\n  conta.\n\n## ⚠️ Não commitar `./auth/`\n\nA pasta `./auth/` contém as suas credenciais de sessão. **Nunca a commite** no\ngit. Ela já está listada no `.gitignore`. Vazá-la equivale a entregar o acesso\nà sua conta do WhatsApp.\n","readmeFilename":"README.md"}