snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)
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 3s

This commit is contained in:
upstream-mirror
2026-09-17 23:28:13 +05:00
commit e7da97194a
32688 changed files with 4208681 additions and 0 deletions

View File

@@ -0,0 +1,289 @@
---
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>