Files
upstream-mirror e7da97194a
Some checks failed
App Prod-Parity E2E Dispatch / dispatch (push) Failing after 10s
CD Storybook UI / build (push) Failing after 3m25s
CD Storybook UI / dispatch (push) Has been skipped
CD deploy main / website-changed-files (push) Successful in 18m8s
CI Agent Skills / changed-files-check (push) Successful in 18m9s
CI Create App E2E minimal / changed-files-check (push) Successful in 24s
CI Create App / changed-files-check (push) Successful in 26s
CI Docs / changed-files-check (push) Successful in 26s
CI Emails / changed-files-check (push) Successful in 28s
CI Example App Hello World / changed-files-check (push) Successful in 23s
CI Front / changed-files-check (push) Has been skipped
CI Example App Postcard / changed-files-check (push) Successful in 27s
CI UI / changed-files-check (push) Has been skipped
CI Utils Test / changed-files-check (push) Successful in 45s
CI Twenty Apps / discover (push) Successful in 1m3s
CD deploy main / deploy-main (push) Failing after 3s
CI Agent Skills / agent-skills-validate (push) Has been skipped
CI Create App / create-app-test (lint) (push) Has been skipped
CI Emails / emails-test (push) Has been skipped
CI Front / front-task (lingui:compile) (push) Has been skipped
CI Front / front-task (lint) (push) Has been skipped
CI Example App Postcard / example-app-postcard (push) Has been skipped
CI UI / ui-task (lint) (push) Has been skipped
CI UI / ui-task (pack-size) (push) Has been skipped
CI UI / ui-task (size) (push) Has been skipped
CI UI / ui-task (test) (push) Has been skipped
CI UI / ui-task (typecheck) (push) Has been skipped
CI Utils Test / utils-test (push) Has been skipped
CI Twenty Apps / ${{ matrix.app.name }} (push) Has been skipped
CI Emails / ci-emails-status-check (push) Successful in 2s
CI Example App Hello World / ci-example-app-hello-world-status-check (push) Successful in 2s
CI Example App Postcard / ci-example-app-postcard-status-check (push) Successful in 3s
CI UI / ui-sb-test (push) Has been skipped
CI Utils Test / ci-utils-test-status-check (push) Successful in 2s
CI Twenty Apps / ci-twenty-apps-status-check (push) Successful in 2s
CI UI / ci-ui-status-check (push) Successful in 2s
CI Desktop / desktop (push) Failing after 1m8s
Push docs to Crowdin / Push documentation to Crowdin (push) Failing after 55s
Push translations to Crowdin / Extract and upload translations (push) Failing after 5s
Push website translations to Crowdin / Extract and upload website translations (push) Failing after 5s
CI Create App / create-app-test (test) (push) Has been skipped
CI Create App / create-app-test (typecheck) (push) Has been skipped
CI Docs / docs-lint (push) Has been skipped
CI Example App Hello World / example-app-hello-world (push) Has been skipped
CI Front / front-task (lingui:extract) (push) Has been skipped
CI Front / front-task (test) (push) Has been skipped
CI Front / front-task (typecheck) (push) Has been skipped
CI UI / ui-sb-build (push) Failing after 1m32s
CI Twenty Apps / ${{ matrix.app.name }} (${{ matrix.server-source }}) (push) Has been skipped
CI Agent Skills / agent-skills-publish (push) Has been skipped
CI Create App / ci-create-app-status-check (push) Successful in 2s
CI Agent Skills / agent-skills-remote-source (push) Has been skipped
CI Create App E2E minimal / create-app-e2e-minimal (push) Has been cancelled
CI E2E Main / e2e-test (push) Has been cancelled
CI Front / front-sb-build (push) Has been cancelled
CI Front / front-build (push) Has been cancelled
CI Create App E2E minimal / ci-create-app-e2e-minimal-status-check (push) Has been cancelled
CI E2E Main / ci-e2e-main-status-check (push) Has been cancelled
CI E2E Main / notify-main-ci-failure (push) Has been cancelled
CI E2E Main / qa-scout-comment (push) Has been cancelled
CI Front / front-sb-test (push) Has been cancelled
CI Front / front-sb-screenshots (push) Has been cancelled
CI Front / ci-front-status-check (push) Has been cancelled
DPA Sub-Processor Sync / sync-subprocessors (push) Failing after 3s
AI Catalog Sync / sync-catalog (push) Failing after 2s
snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
2026-09-17 23:28:13 +05:00

290 lines
12 KiB
Plaintext
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: Migrace z jiných CRM
description: Podrobný průvodce krok za krokem pro migraci vašich dat z libovolného CRM do Twenty.
---
## Přehled
Tento průvodce vás provede migrací vašich dat z libovolného CRM do Twenty. Proces zahrnuje audit vašich dat, přípravu vašeho pracovního prostoru Twenty, export z vašeho současného systému a import do Twenty.
<Note>Zobrazení, pracovní postupy a oprávnění je po migraci nutné vytvořit ručně. Naplánujte si čas na tuto konfigurační práci.</Note>
## Krok 1: Proveďte audit svých aktuálních dat
Migrace je příležitostí k novému začátku. Nepřenášejte balast.
**Co ponechat:**
* Aktivní kontakty a společnosti
* Otevřené obchodní příležitosti a obchody
* Důležité poznámky a aktivity
* Vlastní pole, která skutečně používáte
**Co nechat za sebou:**
* Zastaralé kontakty (bez aktivity 2 a více let)
* Duplicitní záznamy
* Testovací data
* Nepoužívaná vlastní pole
## Krok 2: Zmapujte svůj datový model
Vytvořte mapovací dokument mezi vaším současným CRM a Twenty:
| Vaše CRM | Twenty |
| -------------------- | -------------------------- |
| Účet / organizace | **Společnost** |
| Kontakt / osoba | **Lidé** |
| Obchod / příležitost | **Příležitost** |
| Aktivita | **Úkol** nebo **Poznámka** |
| Vlastní objekt | **Vlastní objekt** |
**Pro každé pole zdokumentujte:**
* Název zdrojového pole
* Cílové pole v Twenty
* Jakékoli potřebné úpravy formátu (datumy, telefonní čísla apod.)
<Note>Mějte tento mapovací dokument po ruce během importu — budete na něj odkazovat při mapování sloupců.</Note>
## Krok 3: Nastavte svůj pracovní prostor Twenty
Před importem dat připravte svůj pracovní prostor Twenty:
### Vytvořte vlastní objekty a pole
1. Přejděte do **Nastavení → Datový model**
2. Vytvořte všechny vlastní objekty, které potřebujete
3. Přidejte vlastní pole ke standardním i vlastním objektům
4. Nastavte vlastnosti polí (jedinečné, povinné, možnosti výběru apod.)
<Warning>
**Všechna pole musí existovat před importem.**
Import CSV vytváří záznamy, nikoli pole. Vytvořte všechna vlastní pole v Nastavení → Datový model před importem.
</Warning>
### Pozvěte svůj tým
<Warning>
**Pozvěte uživatele PŘED importem dat.**
Pokud vaše data obsahují odkazy na uživatele (vlastník účtu, přiřazený uživatel apod.), tito uživatelé musí v Twenty existovat před importem. Jinak tyto relace nelze namapovat.
</Warning>
1. Přejděte na **Nastavení → Členové**
2. Pozvěte všechny členy týmu
3. **Počkejte, až všichni přijmou** své pozvání
4. Ověřte, že se všichni uživatelé zobrazují v seznamu Members
## Krok 4: Export z vašeho stávajícího CRM
Exportujte svá data ze svého stávajícího CRM:
1. Najděte funkci **Export** (obvykle v Nastavení, Správě dat nebo Administraci)
2. Pokud možno exportujte do **formátu CSV**
3. Exportujte každý typ objektu zvlášť (Společnosti, Kontakty, Obchody apod.)
4. Zahrňte všechna pole, která chcete migrovat
**Exportujte tyto objekty (v tomto pořadí pro referenci):**
1. Společnosti / Účty / Organizace
2. Kontakty / Lidé
3. Obchody / Příležitosti
4. Poznámky a aktivity
5. Vlastní objekty
## Krok 5: Vyčistěte a naformátujte svá data
Otevřete každý exportovaný soubor CSV v tabulkovém editoru a připravte jej pro Twenty.
### Odstraňte duplicity
1. Seřaďte podle jedinečného pole (e-mail u lidí, doména u společností)
2. Odstraňte nebo sloučte duplicitní řádky
3. Ověřte, že v Twenty již neexistují žádné duplicity
### Správně naformátujte pole
| Typ pole | Požadovaný formát |
| ---------------------- | ------------------------------------------------- |
| **Doména** | `https://domain.com` |
| **Email** | `name@domain.com` (musí být jedinečná) |
| **Datum** | `YYYY-MM-DD` |
| **Telefon** | Tři sloupce: číslo, kód země, telefonní předvolba |
| **Booleovská hodnota** | `TRUE` nebo `FALSE` (velkými písmeny) |
| **Výběrová pole** | Používejte názvy API, nikoli zobrazované štítky |
<Warning>
**Formát domény je zásadní.**
Použijte `https://domain.com` (ne `domain.com` ani `www.domain.com`). To odpovídá formátu Twenty a předchází duplicitám, když připojíte synchronizaci e-mailu/kalendáře.
</Warning>
Úplné požadavky na formátování pro všechny typy polí viz [Jak připravit soubory CSV](/l/cs/user-guide/data-migration/how-tos/prepare-your-csv-files).
### Přidejte relační sloupce
Pro propojení záznamů (např. lidé se společnostmi) přidejte sloupec s jedinečným identifikátorem nadřazeného záznamu.
**Příklad: CSV s lidmi a odkazem na společnost**
```csv
firstName,lastName,email,companyDomain
John,Smith,john@acme.com,https://acme.com
Jane,Doe,jane@widgets.co,https://widgets.co
```
Podrobné pokyny k propojení záznamů viz [Jak importovat relace](/l/cs/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv).
### Aktualizujte odkazy na uživatele
Pokud vaše data obsahují přiřazení uživatele (vlastník, přiřazený uživatel):
1. Přidejte sloupec s **e-mailem uživatele** (nejen jeho ID ze starého systému)
2. Použijte stejné e-mailové adresy, které uživatelé použili při připojení do vašeho pracovního prostoru Twenty
Kompletní průvodce formátováním viz [Jak připravit soubory CSV](/l/cs/user-guide/data-migration/how-tos/prepare-your-csv-files).
## Krok 6: Import do Twenty
<Warning>
**Na pořadí importu záleží!**
Vždy importujte v tomto pořadí:
1. **Společnosti** jako první (bez závislostí)
2. **Lidé** jako druzí (propojení se společnostmi)
3. **Příležitosti** jako třetí (propojení se společnostmi/lidmi)
4. **Poznámky a úkoly** (propojení na záznamy)
5. **Vlastní objekty** podle jejich závislostí
Nadřazený záznam musí existovat dříve, než na něj můžete odkazovat.
</Warning>
### Importujte každý objekt
Pro každý soubor CSV, v daném pořadí:
1. Přejděte k objektu v Twenty
2. Klikněte na **⋮ → Import records**
3. Nahrajte soubor CSV
4. Namapujte sloupce na pole:
* Namapujte sloupce s e-maily uživatelů na příslušná relační pole
* Namapujte sloupce relací (např. `companyDomain`) na relační pole
5. Zkontrolujte a opravte případné chyby v uživatelském rozhraní
6. Potvrďte import
7. Ověřte několik záznamů, než přejdete k dalšímu souboru
**Podrobné návody:**
* [Jak importovat společnosti](/l/cs/user-guide/data-migration/how-tos/import-companies-via-csv)
* [Jak importovat kontakty](/l/cs/user-guide/data-migration/how-tos/import-contacts-via-csv)
* [Jak importovat relace](/l/cs/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
## Krok 7: Rozsáhlé migrace (50 000+ záznamů)
Pro rozsáhlé migrace:
| Objem | Doporučený postup |
| ----------------------- | ---------------------------- |
| Méně než 10 000 záznamů | Jeden import CSV |
| 10 000–50 000 záznamů | Rozdělte do více souborů CSV |
| 50 000+ záznamů | Použijte API |
**Pro importy přes API:**
* Rychlejší a spolehlivější pro velké datové sady
* Podporuje dávkové operace (až 60 záznamů na jedno volání)
* Viz [Jak importovat data přes API](/l/cs/user-guide/data-migration/how-tos/import-data-via-api)
## Krok 8: Nastavení po migraci
Po importu dat dokončete konfiguraci pracovního prostoru:
### Znovu vytvořte zobrazení
* Nastavte uložená zobrazení s filtry, řazením a nastavením sloupců
* Vytvořte případná kanbanová nebo kalendářová zobrazení
### Znovuvytvoření pracovních postupů
* Znovu vytvořte automatizace v **Settings → Workflows**
* Začněte s nejdůležitějšími pracovními postupy
* Každý z nich otestujte, než se na něj spolehnete
### Nakonfigurujte role a oprávnění
* Nakonfigurujte role v **Settings → Members → Roles**
* Přiřaďte uživatele ke vhodným rolím
### Propojte e-mail a kalendář
* Každý uživatel si připojí svůj účet v **Nastavení → Účty**
* Twenty začne synchronizovat e-maily k záznamům kontaktů
* Viz [E-mail a kalendář](/l/cs/user-guide/calendar-emails/overview)
### Vyškolte svůj tým
* Společně si projděte nové rozhraní
* Zdokumentujte procesy specifické pro tým
## Běžné problémy a řešení
| Problém | Příčina | Řešení |
| ---------------------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------- |
| **Chyby duplicit** | E-mail/doména již existuje | Odstraňte duplicity ze souboru, nebo uveďte jedinečný identifikátor pro aktualizaci existujících záznamů |
| **Vztah nebyl nalezen** | Nadřazený záznam neexistuje | Nejprve importujte nadřazené objekty (společnosti před lidmi) |
| **Chybějící pole** | Vlastní pole neexistuje | Vytvořte pole v Nastavení → Datový model před importem |
| **Chyby u výběrových polí** | Používání zobrazovaných štítků | Používejte názvy API (pro jejich zobrazení povolte v Nastavení režim pro pokročilé) |
| **Prázdná relace uživatele** | Uživatel nepřijal pozvánku | Ujistěte se, že všichni uživatelé přijali pozvánky před importem |
Podrobné kroky pro řešení problémů viz [Jak opravit chyby importu](/l/cs/user-guide/data-migration/how-tos/fix-import-errors).
## Post-migrační kontrolní seznam
### Integrita dat
<Check>Všechny záznamy byly importovány (porovnejte počty se zdrojovým systémem)</Check>
<Check>Relace fungují správně (lidé jsou propojeni se společnostmi)</Check>
<Check>Přiřazení uživatelů je správně namapováno (vlastník, přiřazený uživatel)</Check>
<Check>Vlastní pole vyplněna</Check>
<Check>Žádné neočekávané duplicity</Check>
### Konfigurace
<Check>Zobrazení znovu vytvořena</Check>
<Check>Pracovní postupy znovu vytvořeny a otestovány</Check>
<Check>Role a oprávnění nakonfigurovány</Check>
<Check>Synchronizace e-mailu/kalendáře připojena</Check>
### Připravenost týmu
<Check>Tým proškolen v novém systému</Check>
<Check>Plán přístupu ke starému CRM rozhodnut (ponechat pro referenci? Kdy vypnout?)</Check>
## Časté dotazy
<AccordionGroup>
<Accordion title="Mohu migrovat pracovní postupy automaticky?">
V tuto chvíli ne. Pracovní postupy je nutné v Twenty znovu vytvořit ručně.
</Accordion>
<Accordion title="A co souborové přílohy?">
Souborové přílohy nejsou součástí exportů CSV. Budete je muset znovu nahrát ručně, migrovat je přes API, nebo požádat náš tým o pomoc.
</Accordion>
<Accordion title="Mohu během migrace ponechat oba systémy v provozu?">
Ano, doporučujeme ponechat vaše staré CRM v provozu, dokud neověříte, že je migrace dokončena. Jen si dejte pozor, abyste nevytvářeli nová data na obou místech.
</Accordion>
<Accordion title="Jak dlouho obvykle migrace trvá?">
Záleží na objemu a složitosti dat. Menší migrace (do 10 000 záznamů) lze zvládnout během několika hodin. Rozsáhlé migrace mohou trvat několik dní, včetně čištění dat a testování.
</Accordion>
</AccordionGroup>
## Potřebujete pomoc?
<Tip>
Chcete pomoc s migrací? [Najít certifikovaného dvaceti partnerů](https://twenty.com/partners/list?categories=SOLUTIONING\&ref=docs-migrate-crm) pro přesun vašich dat, plynovodů a uživatelů od konce ke konci.
</Tip>