Zapier, Make, n8n, Pipedream 연결하기

팀이 이미 사용하는 자동화 도구에서 작업을 예약하고 이벤트에 반응하세요 — 코드가 필요 없거나, 아주 조금만 필요합니다.

Zapier, Make, n8n, Pipedream용 공식 Crisphive 앱이 곧 출시됩니다. 모두 여기에서 설명하는 동일한 공개 API를 사용하므로, 앱이 하는 모든 일은 각 플랫폼의 범용 HTTP 및 웹훅 단계로 오늘 바로 할 수 있습니다.

앱이 하는 일

한 번의 호출로 예약하고 확정하기

자동화는 보통 생성 → 견적 → 시간대 선택 → 확정으로 이어지는 전체 플로우를 실행할 수 없습니다. book-and-confirm은 이 모든 것을 한 번의 요청으로 처리합니다. 작업을 생성하고, 작업 유형의 기본 소요 시간(또는 여러분이 보낸 job_duration_minutes)으로 규모를 정한 뒤, scheduled_at에 확정하며, 기사는 Crisphive가 선택합니다.

curl -X POST "https://api.crisphive.com/v1/job-requests/book-and-confirm" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \
  -H "Idempotency-Key: form-submission-4815" \
  -H "Content-Type: application/json" \
  -d '{"customer":{"full_name":"Lamar Bakery","phone":"+16135550142"},"address":{"line":"120 Bank St","city":"Ottawa","state":"ON","postal_code":"K1P 5N1","country":"CA"},"scheduled_at":"2026-10-06T10:00:00"}'

• scheduled_at은 비즈니스의 현지 벽시계 시간이며, 시간대 오프셋을 포함하지 않습니다.
• customer_id 또는 customer 객체를 보내세요. 이미 존재하는 발신자(같은 전화번호 또는 이메일)는 매칭되며, 절대 중복 생성되지 않습니다.
• job_type_id는 선택 사항입니다. 생략하면 비즈니스의 기본 작업 유형(“General”)이 사용됩니다. 자동화가 예약할 수 있는 모든 작업 유형에는 기본 소요 시간이 있어야 합니다.
• 잘못된 입력은 일반적인 4xx로 거부되며 아무것도 생성되지 않습니다.
• 작업이 한 번 생성되면 절대 버려지지 않습니다. 그 시간에 작업을 맡을 수 있는 기사가 없으면 호출은 여전히 200으로 응답하고 confirmed: false와 refusal(확정 단계가 반환했을 것과 같은 error_code와 data)을 담으며, 작업은 코디네이터의 대기열에서 기다립니다.

트리거: 웹훅으로 구독하기

트리거는 여러분이 켤 때 자동화 플랫폼이 생성하고 끌 때 삭제하는 웹훅입니다(“REST hook”). 이벤트 목록은 GET /v1/webhooks/event-types에서 가져오므로, 앱을 업데이트하지 않아도 새 Crisphive 이벤트가 나타납니다.

누가 무엇을 연결할 수 있나요

• 트리거를 켜려면 Developer 접근 권한이 필요합니다(developer_manage_api_keys). 기본적으로 비즈니스 소유자만 이 권한을 가지며, 소유자는 역할 매트릭스에서 다른 그룹에 Developer 모듈을 부여할 수 있습니다.
• 트리거는 연결된 계정이 읽을 수 있는 이벤트만 구독할 수 있습니다. customer.*는 customers_view, technician.*는 team_view, job_request.*는 job_view가 필요합니다. 그 외에는 403 WEBHOOK_EVENT_NOT_PERMITTED로 거부됩니다.
• 예약에는 job_create와 job_manage가 필요합니다.
• 앱이나 API 키가 비즈니스의 이벤트를 처음 구독하면 소유자와 관리자에게 이메일이 발송됩니다.
• 구독은 이를 생성한 API 키가 폐기되거나, 앱의 연결이 해제되거나, 앱을 연결한 멤버가 떠나거나 정지되면 스스로 중단됩니다.

인증

n8n과 Pipedream은 API 키로 연결합니다(샌드박스 데이터로 시험해 보려면 chsk_test_…, 실제 작업에는 chsk_live_…). Zapier와 Make는 OAuth로 연결합니다. 연결하는 사람이 Crisphive에 로그인해 앱을 승인하면, 그 연결은 그 사람이 대시보드에서 할 수 있는 일만 할 수 있습니다.