메인 콘텐츠로 건너뛰기

커뮤니케이션 트리거

커뮤니케이션 트리거는 수신 이메일, EKB 녹화 회의 종료 또는 Telegram 봇이 수신한 메시지에 응답하여 실행됩니다.

이메일​

Gmail 또는 Office 365 받은편지함을 폴링하여 일치하는 이메일이 발견되면 워크플로우를 실행합니다. 발신자 주소, 제목줄 키워드 및 읽음 상태로 필터링할 수 있습니다. 첨부 파일은 선택적으로 포함하여 다운스트림 노드에 전달할 수 있습니다.

언제 사용하나요

  • 특정 이메일이 도착하면 워크플로우가 자동으로 반응하도록 하려는 경우.
  • 이메일-투-작업 파이프라인을 구축하는 경우(예: 이메일로 송장 수신 → 데이터 추출 → CRM에 레코드 생성).
  • 이메일 첨부 파일을 프로그래밍 방식으로 처리해야 하는 경우.

구성

설정유형설명
email_provider문자열gmail로 설정.
poll_interval정수받은편지함을 확인하는 빈도(초).
filters.unread_only부울true이면 읽지 않은 이메일만 워크플로우를 트리거합니다.
filters.from_email문자열이 발신자 주소의 이메일에 대해서만 트리거합니다.
filters.subject_contains문자열제목에 이 키워드나 구문이 포함된 경우에만 트리거합니다.
options.include_attachments부울true이면 첨부 파일 데이터가 트리거 출력에 포함됩니다.
참고

이 트리거를 사용하기 전에 프로젝트에서 Gmail OAuth 연결을 구성해야 합니다.

출력 변수

변수설명
trigger.email.from발신자의 이메일 주소.
trigger.email.to수신자 이메일 주소.
trigger.email.subject이메일의 제목줄.
trigger.email.body이메일의 평문 본문.
trigger.email.attachments첨부 파일 객체 배열(파일 이름, MIME 유형, 콘텐츠). include_attachments가 활성화된 경우에만 채워집니다.
trigger.email.date이메일을 수신한 시점의 ISO 8601 형식 타임스탬프.
참고
  • 필터는 누적됩니다. from_email과 subject_contains가 모두 설정된 경우 트리거가 실행되려면 두 조건이 모두 충족되어야 합니다.
  • 프로덕션 워크플로우에서 이미 처리된 이메일의 재처리를 방지하려면 unread_only를 true로 설정합니다.
  • 단일 이메일에서 여러 첨부 파일을 처리하려면 루프 노드와 함께 trigger.email.attachments를 사용합니다.

EKB 회의 종료​

EKB 녹화 회의가 종료되고 메모 또는 작업 항목이 생성되면 자동으로 실행됩니다. 요약 배포, 후속 작업 생성 또는 회의 인사이트를 CRM 또는 프로젝트 관리 도구에 기록하는 것과 같은 회의 후 자동화 워크플로우를 구축하는 데 사용합니다.

언제 사용하나요

  • 회의가 끝나자마자 회의 메모 또는 작업 항목을 자동으로 처리하려는 경우.
  • 회의 후 파이프라인을 구축하는 경우(예: 회의 종료 → 작업 항목 추출 → 프로젝트 관리 도구에서 작업 생성).
  • 회의 요약을 지식 베이스 또는 CRM 레코드에 자동으로 기록해야 하는 경우.

구성

설정유형설명
도구 설명문자열도구 페이지에 표시되는 도구에 대한 설명.
확인 필요부울활성화하면 사용자가 워크플로우를 실행하기 전에 확인해야 합니다.
워크플로우 패널 열기부울활성화하면 이 플로우가 채팅에서 실행될 때 워크플로우 미리보기 패널을 표시합니다.
API 키문자열인증을 위한 EKB API 키.
API 시크릿문자열인증을 위한 EKB API 시크릿.
프로젝트 ID문자열EKB 프로젝트 ID.
모든 회의에 대해 활성화부울활성화하면 회의(귀하가 참여하는)가 종료되는 것에 관계없이 트리거가 실행됩니다.
이벤트 유형문자열트리거를 실행하는 회의 이벤트. 기본값은 회의 완료입니다.
작업 유형문자열회의 종료 시 수신할 데이터 유형. 옵션은 메모와 작업 항목입니다.

사용 가능한 변수

변수설명
{{trigger.meeting.title}}종료된 회의의 제목.
{{trigger.meeting.notes}}회의에서 AI가 생성한 메모.
참고
  • 인증을 위해 EKB API 자격 증명(API 키, API 시크릿 및 프로젝트 ID)이 필요합니다.
  • 모든 회의에 대해 활성화가 켜져 있으면 귀하가 참여하는 모든 회의에 대해 트리거가 실행됩니다. 특정 회의로 트리거를 제한하려면 비활성화합니다.
  • 작업 유형은 트리거가 다운스트림 노드에 회의 메모를 제공할지 작업 항목을 제공할지를 결정합니다.
  • 회의 데이터는 {{trigger.meeting.title}}, {{trigger.meeting.notes}} 및 회의 페이로드의 다른 필드를 통해 액세스할 수 있습니다.

Telegram: 새 메시지​

Telegram 봇이 새 메시지를 받으면 실행됩니다. 트리거는 Telegram이 업데이트를 POST하는 웹훅을 사용하여 메시지를 받을 때마다 워크플로우를 시작합니다.

언제 사용하나요

  • 사용자 메시지에 자동화된 워크플로우로 응답하는 Telegram 봇을 구축하려는 경우.
  • 수신 Telegram 메시지를 AI 에이전트 또는 처리 파이프라인에 라우팅하는 경우.
  • Telegram 봇에 전송된 메시지를 실시간으로 캡처하고 처리해야 하는 경우.

구성

설정유형설명
도구 설명문자열도구 페이지에 표시되는 도구에 대한 설명.
확인 필요부울활성화하면 사용자가 워크플로우를 실행하기 전에 확인해야 합니다.
워크플로우 패널 열기부울활성화하면 이 플로우가 채팅에서 실행될 때 워크플로우 미리보기 패널을 표시합니다.
허용된 HTTP 메서드문자열웹훅이 수용하는 HTTP 메서드. 기본값은 POST입니다.
인증문자열수신 웹훅 요청의 인증 방법. 기본값은 없음입니다.
응답 모드문자열웹훅이 수신 요청에 응답하는 방법. 즉시 응답은 즉시 200 OK 응답을 반환합니다.

웹훅 설정

  1. 도구 게시

    워크플로우를 게시하여 웹훅 엔드포인트를 활성화하고 라이브 URL을 생성합니다.

  2. Telegram에 웹훅 등록

    라이브 URL을 복사하고 telegram_set_webhook 도구 또는 다음 curl 명령을 사용하여 Telegram 봇에 등록합니다:

    curl -X POST "https://api.telegram.org/bot<TOKEN>/setWebhook" \
      -H "Content-Type: application/json" \
      -d '{"url":"<WEBHOOK_URL>","allowed_updates":["message"]}'
  3. 봇에 메시지 전송

    Telegram 봇에 메시지를 보냅니다. Telegram이 업데이트를 웹훅 URL로 POST하여 워크플로우를 시작합니다.

샘플 데이터 캡처 (선택)

워크플로우를 실행하지 않고 테스트 실행을 위해 실제 페이로드를 저장하려면 봇에 다음 명령을 보냅니다:

/generate_test_message Hello world

캡처된 페이로드를 로드하려면 새로고침을 클릭합니다.

사용 가능한 변수

변수설명
{{trigger.body}}요청 본문 (JSON 파싱됨).
{{trigger.headers}}요청 헤더.
{{trigger.query}}쿼리 매개변수.
{{trigger.method}}HTTP 메서드.
{{trigger.body.message.text}}수신 Telegram 메시지의 텍스트 콘텐츠.
{{trigger.body.message.chat.id}}메시지가 전송된 대화의 채팅 ID.
참고
  • 테스트 URL (라이브 URL에 /test 추가)은 워크플로우를 실행하지 않고 샘플 데이터를 생성합니다.
  • 메시지 데이터는 {{trigger.body.message.text}}, {{trigger.body.message.chat.id}} 및 Telegram 업데이트 페이로드의 다른 필드를 통해 액세스할 수 있습니다.
  • 외부 서비스가 웹훅 URL로 HTTP 요청을 보내며 각 요청은 새 워크플로우 실행을 트리거합니다.
  • Telegram에 등록하기 전에 도구를 게시하여 웹훅 엔드포인트를 활성화합니다.