twenty-crm

Skill umożliwia interakcję z samodzielnie hostowaną instancją Twenty CRM za pośrednictwem REST i GraphQL. Możesz tworzyć, wyszukiwać, aktualizować i usuwać obiekty takie jak firmy, bez konieczności ręcznego logowania do panelu. Wystarczy skonfigurować adres URL instancji i klucz API, a następnie używać gotowych skryptów do automatyzacji operacji na danych CRM.

1. Przygotuj plik konfiguracyjny, tworząc config/twenty.env na podstawie szablonu config/twenty.env.example. Wpisz w nim TWENTY_BASE_URL (adres Twojej instancji, np. https://crm.example.com lub http://localhost:3000) oraz TWENTY_API_KEY (token Bearer do autoryzacji).

2. Zweryfikuj połączenie, wykonując prosty skrypt GraphQL: skills/twenty-crm/scripts/twenty-graphql.sh 'query { companies(limit: 5) { totalCount } }'. Jeśli zwróci liczbę firm, konfiguracja jest poprawna.

3. Do wyszukiwania firm używaj skryptu skills/twenty-crm/scripts/twenty-find-companies.sh "nazwa" 10, gdzie "nazwa" to fragment nazwy firmy, a 10 to maksymalna liczba wyników. Skrypt automatycznie obsługuje filtrowanie.

4. Aby utworzyć nową firmę, uruchom skills/twenty-crm/scripts/twenty-create-company.sh "Nazwa Firmy" "domena.com" 100, gdzie ostatni parametr to liczba pracowników. Skrypt wyśle żądanie POST z odpowiednimi danymi.

5. Dla bardziej zaawansowanych operacji (aktualizacja, usunięcie) użyj niskopoziomowych helperów: twenty-rest-patch.sh do modyfikacji pól (np. liczby pracowników) lub twenty-rest-delete.sh do usunięcia rekordu. Pamiętaj, że identyfikatory i nazwy endpointów mogą się różnić w zależności od wersji Twenty i konfiguracji workspace'u.

6. Jeśli token API wygaśnie, odśwież go w ustawieniach Twenty i zaktualizuj TWENTY_API_KEY w pliku config/twenty.env.