개발자를 위해

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에 공개되어 있습니다. 플랫폼 안의 문서 페이지에서 인증, 스코프, 오류, 각 경로의 예시를 설명합니다.

도구

유료 커넥터 없이 n8n, Make, Zapier

이 도구들의 HTTP 요청 노드에 내 키를 사용하고, 그 도구의 webhook은 “webhook 실행” 블록에서 사용하세요.

  • n8n
  • Make
  • Zapier
채널 토큰과 webhook 시크릿은 암호화되어 저장되고, 플랫폼에서 나가는 요청에서는 내부 주소가 차단되며, API는 키를 만든 사람의 직책 권한을 따릅니다.

플랜

플랜별 API

REST API와 API 키는 Growth 플랜부터 제공됩니다. “Webhook 수신” 트리거와 요청 블록은 모든 플랜의 Workflow에서 사용할 수 있습니다.

플랜월REST APIWorkflow의 Webhook 수신과 HTTP
Starter Free무료—예
LiteR$ 197,90—예
GrowthR$ 397,90예예
ProR$ 797,90예예
ScaleR$ 1.497,90예예

월 단위, 브라질 헤알(BRL) 기준이며, 연간 결제 시 10개월 요금으로 12개월을 사용합니다. 모든 플랜 보기

여기서 계속하세요

자주 묻는 질문

개발자가 연동 전에 자주 묻는 질문.

예, Growth 플랜부터 제공됩니다. 리드, 연락처, 파이프라인, 태그, 상품, 제안서, WhatsApp 메시지, 대화, Workflow, 캠페인, 이메일, 팀, 작업, 보드, 알림을 다루는 약 128개 경로의 REST API입니다.
설정 › 오픈 API에서 만든 키를 Authorization: Bearer 헤더로 전송합니다. 각 키는 리소스별 스코프(읽기 또는 쓰기), 1~730일의 유효 기간, 선택적 IP 목록, 사용 기록을 갖습니다. 키는 한 번만 표시되며 교체하거나 폐기할 수 있습니다.
키당 분당 120건의 요청을 처리하며, 초과하면 429 응답과 대기 시간이 반환됩니다. 기업당 최대 20개의 활성 키를 사용할 수 있습니다.
API의 POST /v1/leads 경로 또는 Workflow의 “Webhook 수신” 트리거를 통해 보냅니다. 후자는 시스템, n8n, Make, Zapier가 데이터를 보낼 수 있는 고유 주소를 제공합니다. x-api-key 키를 쓰던 기존 리드 webhook은 더 이상 제공되지 않습니다.
발신 webhook은 이메일 마케팅 이벤트(오픈, 클릭, 답장, 수신 거부, 반송, 신고, 목록 가입)를 HMAC-SHA256 서명과 재시도와 함께 전송합니다. 파이프라인, 제안서, 주문의 변경을 시스템에 알리려면 Workflow에서 “webhook 실행” 또는 “HTTP 요청” 블록을 사용하세요.
OpenAPI 3.1 명세와 Postman 컬렉션은 api2.astrify.com.br/v1/openapi.json 및 /v1/postman.json에 공개되어 있으며, 플랫폼에는 인증, 스코프, 오류, 예시를 설명하는 문서 페이지가 있습니다.
Astrify Flows

AAstrify대화 중como시스템dasua회사.

무료 플랜에서 webhook으로 Workflow를 테스트하고, Growth 플랜부터 API를 사용하세요.