Export user data

Exporteer alle Zivver-berichten die door jouw organisatie zijn verzonden en ontvangen, zodat ze beschikbaar zijn voor archiveringsdoeleinden. Gebruik een FTP-client om de berichten van het Zivver-platform naar een lokale locatie over te dragen.

De verbinding via FTP met jouw Zivver-organisatie is standaard uitgeschakeld. Neem contact op met Support om deze in te schakelen.

Berichten worden opgeslagen als EML-bestanden en bevatten eventuele bijlagen. De berichten worden onversleuteld geëxporteerd, wat betekent dat je geen Zivver Client nodig hebt om ze te kunnen lezen.

In de FTP-export worden de berichten als volgt gesorteerd: per account, per maand, per gesprek, per bericht. Dit is een voorbeeld van hoe de mappenstructuur eruit ziet:

  • v3
    • Account: johndoe@example.com
      • Maand: 202407
        • Gesprek: 20240705T120226Z_ee7f2e3j-w51j-642k-yt65-r3fb1233f07w
          • Bericht:
            • 0001_20240705T120226Z.eml
            • 0002_20240711T091921Z.eml
            • 0003_20240711T092203Z.eml

Vereisten

Je kunt elke FTP-client gebruiken die je verkiest, zolang deze kan verbinden met:

  • Host: ftp.zivver.com
  • Versleuteling: Expliciete TLS
  • Poort: 21
  • Passive poorten: 60000-60999 (alleen vereist wanneer je een Passive Transfer Mode moet gebruiken)

Verbinden via FTP

Volg deze stappen om via FTP verbinding te maken met je Zivver-organisatie:

  1. Ga naar Organisatieaccount > Exporteer gebruikersdata in het Zivver Admin Portal van je Zivver-organisatie.
  2. Kopieer de Host, zoals weergegeven.
  3. Open je FTP-client en vul de gekopieerde host in.
  4. Ga terug naar Exporteer gebruikersdata.
  5. Kopieer de Gebruikersnaam, zoals weergegeven.
  6. Open je FTP-client en vul de gekopieerde gebruikersnaam in.
  7. Genereer nu een Zivver API-sleutel.
  8. Open je FTP-client en vul de gegenereerde API-sleutel in als het wachtwoord voor de FTP-verbinding.
  9. Zorg ervoor dat de verbinding wordt gemaakt via poort 21.
  10. Zorg ervoor dat de verbinding Expliciete TLS gebruikt voor versleuteling.
  11. Zorg ervoor dat logging is ingeschakeld en opgeslagen naar een lokaal bestand voor latere referentie.
  12. Test de verbinding.

FAQ

Foutmelding: 530 Authenticatie mislukt

Wanneer je probeert verbinding te maken en een 530 Authenticatie mislukt foutmelding krijgt, kunnen de volgende oorzaken mogelijk zijn:

  1. Wanneer je voor de eerste keer een FTP-verbinding probeert te maken: de verbinding via FTP naar je Zivver-organisatie is waarschijnlijk nog niet ingeschakeld. Neem contact op met Support om dit in te schakelen.
  2. Wanneer je eerder een FTP-export hebt gemaakt, maar nu ineens deze foutmelding krijgt: de API-sleutel kan verwijderd of ongeldig zijn. De API-sleutel wordt gebruikt als wachtwoord voor de FTP-verbinding. Controleer of de sleutel geldig is en genereer een nieuwe sleutel indien nodig.

Foutmelding: De gegevensverbinding kon niet worden gemaakt (ECONNREFUSED)

Je kunt via FTP verbinding maken met je Zivver-organisatie, maar je kunt geen berichten overdragen. Je krijgt de foutmelding De gegevensverbinding kon niet worden gemaakt: ECONNREFUSED - Verbinding geweigerd door server.

Dit probleem kan zich voordoen wanneer de FTP-client is ingesteld om Passive Transfer Mode te gebruiken, maar de FTP-verbinding kan niet worden gemaakt via poortbereik 60000-60999. Mogelijk moet je de FTP-client in je firewall/proxy toestaan om via dit bereik verbinding te maken met ftp.zivver.com.

Foutmelding: Kritieke bestandoverdracht fout

De fout Kritieke bestandoverdracht fout kan optreden wanneer geprobeerd wordt een .eml-bestand over te dragen, maar het bestand plotseling ontbreekt. Dit kan gebeuren wanneer tijdens een grote FTP-export de intrekkingsdatum van sommige berichten is verstreken.

Sommige berichten ontbreken of zijn leeg in de gesprekmap

Als je merkt dat sommige berichten ontbreken in de map van een specifiek gesprek, kunnen er verschillende redenen zijn:

  1. Het bericht is ingetrokken. Dit betekent dat niemand het ingetrokken bericht nog kan lezen en het bericht dus leeg is in de FTP-export. Je ziet het woord DELETED in de bestandsnaam van het bericht.
  2. Het bericht is ontvangen door een medewerker voordat je organisatie haar eigen Zivver-organisatie had, en die medewerker heeft het bericht nooit meer gelezen terwijl hij/zij een Zivver-account heeft dat deel uitmaakt van je organisatie. Dit betekent dat het bericht nog steeds versleuteld is met de gast-encryptiesleutel. Pas wanneer het bericht opnieuw door de medewerker wordt gelezen met een Zivver-account, worden de sleutels vervangen door account-encryptiesleutels die het mogelijk maken voor beheerders van je organisatie om deze berichten via FTP te exporteren.

Sommige accounts ontbreken in de FTP-export

Als je merkt dat sommige accounts ontbreken in de FTP-export, kunnen de volgende oorzaken mogelijk zijn:

  1. Dit account is een gastaccount en maakt nog geen deel uit van je Zivver-organisatie. Bekijk hoeveel accounts kunnen worden overgenomen voor domeinen die je organisatie heeft geclaimd.
  2. Er is een master key reset uitgevoerd, maar de ontbrekende gebruikers hebben nog niet ingelogd na de reset. Vraag deze gebruikers om in te loggen.

Is de FTP-verbinding veilig?

De FTP-verbinding vereist expliciete TLS. Dit betekent dat de FTP-client eerst verbinding maakt en vervolgens een veilige SSL-verbinding tot stand wordt gebracht.

Hoe kan het versleutelde bericht ongecodeerd geëxporteerd worden?

De FTP-verbinding vereist dat je een gegenereerde API-sleutel gebruikt om de verbinding tot stand te brengen. Deze API-sleutel wordt gebruikt om de versleutelde berichten te ontsleutelen, zodat ze ongecodeerd geëxporteerd kunnen worden.

Hoe groot zal de FTP-export zijn?

Als je FTP-client het toevoegen van bestanden in de wachtrij ondersteunt, kun je de volledige v3-map in de wachtrij plaatsen. De FTP-client toont dan hoe groot de bestanden in de wachtrij zijn.