API 노드

​

언제 사용하나요

• 대화 중 외부 서버에 데이터를 전송해야 할 때 (예: SMS 발송, 주문 접수)
• 외부 시스템에서 데이터를 조회해야 할 때 (예: 주문 상태, 재고 확인)
• API 응답 결과에 따라 대화 흐름을 분기해야 할 때
• 대화에서 수집한 변수를 외부 시스템에 동기화해야 할 때

​

API 구성

​

HTTP 메서드

• GET - 데이터 조회
• POST - 데이터 생성
• PUT - 데이터 수정
• DELETE - 데이터 삭제

​

URL

https://api.example.com/users/{{user_id}}/orders

​

요청 본문

{
  "name": "{{customer_name}}",
  "phone": "{{phone_number}}"
}

​

응답 타임아웃

​

인증

​

헤더

​

응답 변수 추출

​

전환 조건

• 성공적인 API 호출 이후: 사용자가 정의한 조건에 따라 다음 노드로 전환합니다.
  • 예: status == 200 그리고 product_type == 티셔츠 인 경우
  • 예: status == 200 그리고 product_type == 반바지 인 경우
• 요청 실패 시: API 호출중 오류가 발생한 경우 자동으로 “요청 실패 시” 전환 조건을 통해 지정된 노드로 이동합니다.

​

프롬프트 타입

​

실제 사용 예시

​

SMS 전송

{
  "to": "{{phone_number}}",
  "from": "{{agent_phone}}",
  "message": "{{sms_content}}"
}

• 성공 (status == 200): “SMS 발송 완료” 안내 노드로 이동
• 요청 실패 시: “발송 실패” 안내 노드로 이동

​

관련 문서