API i integracje
BetaTwórz oferty tam, gdzie już pracujesz
Poproś ChatGPT albo Claude o ofertę w środku rozmowy albo pozwól, żeby Twój CRM zaczął ją przez Zapier, Make lub n8n. Proposals pisze szkic tym samym silnikiem, w tej samej marce i z tymi samymi kontrolami co w aplikacji, a potem oddaje link. Maila piszesz Ty.
Integracje są w becie i włączamy je osobno dla każdego zespołu. Jeśli w swoim koncie nie widzisz Ustawienia → Integracje, napisz na support@proposals.co, a włączymy je.
Zacznij ofertę w jednym z trzech miejsc
ChatGPT
Podłącz Proposals raz jako konektor. Wklej notatki z rozmowy do czatu i poproś o ofertę.
Claude
Dodaj Proposals jako własny konektor i przygotuj ofertę w tej samej rozmowie, w której szykujesz się do spotkania.
Twój CRM przez Zapier, Make albo n8n
Gdy szansa sprzedaży dochodzi do etapu oferty, wyślij jej notatki do API, a opiekun szansy dostanie wiadomość, gdy szkic będzie gotowy.
Jak to wygląda w ChatGPT
Typowa rozmowa w skrócie. Pytanie zadaje Proposals, maila pisze ChatGPT, a wysyłasz go Ty.
- Ty
Przygotuj ofertę dla Kwiaciarni Lila na podstawie notatek z rozmowy. Sześć podstron, 9 000 zł netto, płatność 50% z góry i 50% po odbiorze. Osoba kontaktowa to Anna Nowak.
- ChatGPT
Zaczynam szkic. Najpierw jedno pytanie od Proposals: w notatkach jest też kwota 12 000 zł. Która jest aktualna?
- Ty
9 000 zł. Kwota 12 000 zł dotyczyła wersji ze zdjęciami produktów.
- ChatGPT
Szkic jest gotowy: sklep z sześcioma podstronami, wyborem daty dostawy i wsparciem po starcie, 9 000 zł netto, połowa z góry. Nic nie blokuje publikacji, a podgląd jest w Twoim koncie Proposals. Opublikować?
- Ty
Opublikuj i napisz do Anny krótkiego maila z linkiem.
- ChatGPT
Opublikowane. Oto szkic maila do Anny z linkiem. Wyślij go ze swojej skrzynki i daj mi znać, a oznaczę ofertę jako wysłaną.
Proposals nigdy nie wysyła tego maila. Wysyłasz go ze swojej skrzynki, a ofertę widzisz w koncie jak każdą inną.
Co zostaje pod Twoją kontrolą
Szkice są prywatne
Utworzenie oferty nigdy jej nie publikuje. Każdy szkic jest w Twoim koncie, gdzie możesz go przejrzeć i poprawić, zanim ktokolwiek go zobaczy.
Publikacja to osobne uprawnienie
Integracja może opublikować ofertę tylko wtedy, gdy ma od Ciebie zgodę na publikację, nic jej nie blokuje, a wywołanie jawnie ją potwierdza. Publikacji nie da się wymusić.
Widzisz, skąd przyszła każda oferta
Oferty z integracji są oznaczone, na przykład „Utworzona w ChatGPT”, i mają historię działań integracji. Publikacja przez integrację wysyła powiadomienie właścicielowi oferty.
Żadnych wymyślonych cen
Cena, którą podasz, jest ceną w ofercie. Gdy notatki sobie przeczą, dostajesz pytanie zamiast zgadywania.
Uprawnienia po ludzku
Wybierasz je przy tworzeniu klucza API albo przy zatwierdzaniu konektora. Klucz ani połączenie nigdy nie mają większych uprawnień niż osoba, która je skonfigurowała.
- Odczyt marek
brands:read - Widzi Twoje marki, żeby oferta wyszła z właściwej.
- Odczyt ofert
proposals:read - Widzi status, pytania, najważniejsze fakty i link oraz to, czy klient otworzył lub zaakceptował ofertę.
- Tworzenie i zmienianie
proposals:write - Tworzy oferty, odpowiada na ich pytania, prosi o poprawki i oznacza oferty jako wysłane.
- Publikowanie
proposals:publish - Uruchamia link do oferty albo go wyłącza. Domyślnie wyłączone, dopóki go nie zaznaczysz.
Limity po ludzku
- Jedna oferta na jedno żądanie. Nie ma importu list ani masowej wysyłki.
- Do dziesięciu nowych ofert na minutę na jeden klucz albo podłączoną aplikację i najwyżej trzy oferty powstające jednocześnie w jednym zespole.
- Do sześćdziesięciu odczytów na minutę i do dwudziestu poprawek w ciągu dziesięciu minut.
- Oferta z integracji liczy się w planie dokładnie tak samo jak oferta z aplikacji. Nie ma osobnej opłaty.
Dla programistów
REST API z kluczami API dla automatyzacji i własnego kodu oraz serwer MCP z OAuth dla asystentów. Każdy POST przyjmuje nagłówek Idempotency-Key, więc ponowione żądanie nigdy nie tworzy drugiej oferty.
- REST API
- https://api.proposals.co/api/public/v1
- Serwer MCP
- https://api.proposals.co/mcp
- OpenAPI
- https://api.proposals.co/api/public/v1/openapi.json
Utworzenie oferty
curl -X POST https://api.proposals.co/api/public/v1/proposals \
-H "Authorization: Bearer $PROPOSALS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: crm-deal-731-create" \
-d '{
"client": {
"name": "Kwiaciarnia Lila",
"contact": { "name": "Anna Nowak", "email": "anna@lila.example" }
},
"context": "Notatki z rozmowy: sklep z sześcioma podstronami, wybór daty dostawy, start w listopadzie...",
"language": "pl",
"pricing": { "amount": 9000, "currency": "PLN", "tax_basis": "net", "billing": "one_off" },
"external_reference": "crm-deal-731"
}'Odpowiedź
202 Accepted
{ "id": 123, "status": "generating", "next_poll_after_ms": 4000, ... }Pełna referencja API →Przewodniki
Krok po kroku, od podłączenia do pierwszej opublikowanej oferty.
- PrzeglądUwierzytelnianie, uprawnienia, statusy, błędy, idempotencja i limity.
- ChatGPTPodłącz Proposals i przygotuj pierwszą ofertę w czacie.
- ClaudeDodaj Proposals jako własny konektor i używaj go w rozmowie.
- Zapier, Make i n8nUtwórz ofertę z szansy sprzedaży w CRM i powiadom opiekuna, gdy będzie gotowa.
- Referencja APIKażdy endpoint z przykładem żądania i odpowiedzi.