개발자를 위해
Astrify 연동을 위한 REST API와 webhook
자체 시스템에서 리드를 만들고, 메시지를 보내고, 보드를 다루고, Workflow를 실행하세요. webhook으로 데이터를 받고 플로 중간에 어떤 API든 호출할 수 있으며, 스코프별 키와 OpenAPI 문서를 제공합니다.
- OpenAPI 3.1과 Postman
- 스코프가 지정된 키
- Growth 플랜부터
터미널
curl -X POST https://api2.astrify.com.br/v1/leads \
-H "Authorization: Bearer astrify_7f3k…" \
-H "Content-Type: application/json" \
-d '{
"nome": "Paula Mendes",
"telefone": "+5511955550000",
"email": "paula@email.com"
}'201 Created
{
"id": "ld_8c21…",
"nome": "Paula Mendes",
"etapa": "Novo lead",
"funil": "Vendas"
}- 128
리드와 메시지부터 보드와 제안서까지 API 경로 수
- 16
키별 읽기 또는 쓰기 스코프를 지정할 수 있는 리소스
- 120
키당 분당 요청 수
- 20
기업당 활성 키, 각각 사용 기록 제공
REST API
API가 하는 일
리소스를 고르고 몇 가지 경로를 확인하세요.
리드와 파이프라인
리드를 만들고 수정하며, 중복을 병합하고, 일괄 가져오기와 활동·메모 기록을 할 수 있습니다. 파이프라인과 단계는 API로 조회됩니다.
- 리드 생성, 조회, 수정, 삭제, 병합
- 일괄 가져오기와 중복 검색
- 딜의 활동, 메모, 참가자, 항목
- 파이프라인, 단계, 유입 경로, 실패 사유 (읽기)
api2.astrify.com.br/v1
- POST/leads
- GET/leads
- PATCH/leads/{lead_id}
- POST/leads/importar-lote
- GET/funis/{funil_id}/etapas
API 키
연동마다 본인의 키 사용
키는 설정 › 오픈 API에서 만들고 Authorization 헤더로 전송합니다. 키는 만든 사람의 권한으로 동작하며, 그 사용자가 비활성화되면 함께 중지됩니다.
- 01
리소스별 스코프
각 키는 선택한 항목(리드, 연락처, 보드, 메시지 등)만 읽거나 쓸 수 있습니다.
- 02
유효 기간과 IP
1~730일의 유효 기간과 최대 20개의 허용 IP 목록.
- 03
한 번만 표시됩니다
키는 생성 시에만 표시되며, Astrify는 키의 서명값만 보관합니다.
- 04
교체 및 폐기
연동을 중단하지 않고 키를 교체하고 즉시 폐기할 수 있으며, 키별 사용 기록을 확인할 수 있습니다.
수신 webhook
시스템이 알리면 Workflow가 실행됩니다
“Webhook 수신” 트리거는 Workflow에 고유 주소를 부여합니다. 자체 시스템, n8n, Make 또는 Zapier의 JSON을 보내면 이메일이나 전화번호로 리드를 찾아 플로를 진행합니다. 수신 대기 모드에서는 Astrify가 첫 전송 내용을 보여 주므로 켜기 전에 필드를 매핑할 수 있습니다.
- GET, POST, PUT, PATCH, 최대 256 KB
- 실제 전송 내용을 확인하는 2분 수신 대기 모드
- 트리거별로 최근 이벤트 50개 보관
- 엔드포인트당 분당 최대 120회 호출
POST /api/webhooks/workflow/{token}
{
"evento": "pagamento_aprovado",
"cliente": {
"nome": "João Prado",
"email": "joao@pradoalimentos.com.br"
},
"valor": 1290.00
}Astrify에서 내 시스템으로
알고 싶은 내용에 따라 두 가지 경로가 있습니다.
Workflow에서
HTTP 요청과 webhook 실행
모든 트리거(리드 단계 변경, 제안서 수락, 주문 배송 완료)는 플로 중간에 시스템을 호출하고 그 응답을 다음 블록에서 사용할 수 있습니다.
- 헤더와 JSON 본문을 지원하는 GET, POST, PUT, PATCH, DELETE
- URL과 본문에 넣는 리드 변수
- 조건 분기용 변수에 저장된 응답
- 응답을 기다리거나, 보내고 바로 진행
발신 webhook
이메일 마케팅 이벤트
설정 › Webhooks에서 최대 10개의 주소를 등록하면 서명된 이벤트를 재시도와 전송 이력과 함께 받습니다.
- email.opened
- email.clicked
- email.replied
- email.unsubscribed
- email.bounced
- email.complaint
- email.list_joined
- X-Astrify-Signature 헤더의 HMAC-SHA256 서명
- 1분, 5분, 30분, 2시간, 6시간 후 재시도
- 재전송과 테스트 버튼이 있는 이력
문서
OpenAPI, Postman, 플랫폼 내 가이드
OpenAPI 3.1 명세와 Postman 컬렉션은 api2.astrify.com.br/v1/openapi.json 및 /v1/postman.json에 공개되어 있습니다. 플랫폼 안의 문서 페이지에서 인증, 스코프, 오류, 각 경로의 예시를 설명합니다.
플랜
플랜별 API
REST API와 API 키는 Growth 플랜부터 제공됩니다. “Webhook 수신” 트리거와 요청 블록은 모든 플랜의 Workflow에서 사용할 수 있습니다.
| 플랜 | 월 | REST API | Workflow의 Webhook 수신과 HTTP |
|---|---|---|---|
| Starter Free | 무료 | — | 예 |
| Lite | R$ 197,90 | — | 예 |
| Growth | R$ 397,90 | 예 | 예 |
| Pro | R$ 797,90 | 예 | 예 |
| Scale | R$ 1.497,90 | 예 | 예 |
월 단위, 브라질 헤알(BRL) 기준이며, 연간 결제 시 10개월 요금으로 12개월을 사용합니다. 모든 플랜 보기
여기서 계속하세요
자주 묻는 질문
개발자가 연동 전에 자주 묻는 질문.

























