Instantly Automation
Instantly를 통해 콜드 이메일 아웃리치를 자동화하세요. 멀티스텝 시퀀스가 포함된 캠페인을 생성 및 관리하고, 발신 일정을 설정하며, 리드를 대량으로 가져오고, 발신 계정을 관리하며, 캠페인 성과를 추적할 수 있습니다. 모든 작업을 자연어 명령어로 수행합니다.
툴킷 문서: composio.dev/toolkits/instantly
설정
- 클라이언트 구성에 Composio MCP 서버를 추가하세요:
https://rube.app/mcp - 안내에 따라 Instantly 계정을 연결하세요 (API 키 인증).
- 자연어 명령어를 사용하여 아웃리치 캠페인을 관리하세요.
핵심 워크플로우
1. 발신 계정 목록 조회
Instantly 워크스페이스에 구성된 모든 이메일 계정을 상태와 제공업체별로 필터링하여 가져옵니다.
툴: INSTANTLY_LIST_ACCOUNTS
예시 프롬프트:
"Instantly 워크스페이스의 활성화된 모든 발신 계정을 보여줘"
주요 파라미터:
status-- 상태별 필터:1(활성),2(일시 중지),-1(연결 오류),-2(소프트 바운스 오류),-3(발신 오류)provider_code-- 제공업체별 필터:1(사용자 정의 IMAP/SMTP),2(Google),3(Microsoft),4(AWS)search-- 이메일 부분 문자열 또는 도메인으로 검색limit-- 최대 항목 수 (1-100)starting_after-- 이전 응답의 페이지네이션 커서tag_ids-- 쉼표로 구분된 태그 UUID 목록
2. 캠페인 생성
일정, 이메일 시퀀스, A/B 테스트 변형, 발신 구성을 포함한 새로운 아웃리치 캠페인을 시작합니다.
툴: INSTANTLY_CREATE_CAMPAIGN
예시 프롬프트:
"'Q1 Outreach'라는 Instantly 캠페인을 만들어줘. 월요일부터 금요일까지 오전 9시부터 오후 5시(중부 표준시)에 발신하고, 3단계 이메일 시퀀스를 포함해"
주요 파라미터:
name(필수) -- 캠페인 이름campaign_schedule(필수) -- 일정 구성:schedules(필수) -- 일정 객체 배열, 각 객체:name-- 일정 이름timing--{from: "09:00", to: "17:00"}(HH:mm 형식)days-- 요일 인덱스 문자열 "0"(일) ~ "6"(토)을 불리언 값으로 매핑한 객체timezone-- 지원 값: "America/Chicago", "America/Detroit", "America/Boise", "America/Anchorage"
start_date/end_date-- ISO 8601 날짜
email_list-- 발신 계정 이메일 주소 배열 (사전 구성된 계정이어야 함; 유효한 주소를 찾으려면INSTANTLY_LIST_ACCOUNTS사용)sequences-- 배열 (첫 번째 요소만 사용됨):steps-- 단계 객체 배열:type-- 반드시 "email"delay-- 다음 이메일까지의 일수 (정수, 최소 0)variants-- A/B 테스트용{subject, body}객체 배열
daily_limit-- 일일 발신 한도email_gap-- 이메일 간 분 간격stop_on_reply-- 리드가 답장하면 캠페인 중지 (불리언)stop_on_auto_reply-- 자동 응답 시 중지 (불리언)open_tracking/link_tracking-- 추적 활성화 (불리언)
타임존 참고사항:
- 작동 확인됨: "America/Chicago" (중부), "America/Detroit" (동부), "America/Boise" (산지)
- 자동 매핑: "America/New_York" -> "America/Detroit", "America/Denver" -> "America/Boise"
- 지원되지 않음: "America/Los_Angeles", "US/Pacific" -- 대안으로 "America/Anchorage" 또는 "America/Dawson" 사용
3. 캠페인 설정 업데이트
기존 캠페인의 일정, 발신 제한, 시퀀스 또는 추적 설정을 수정합니다.
툴: INSTANTLY_UPDATE_CAMPAIGN
예시 프롬프트:
"내 Instantly 캠페인의 일일 발신 한도를 100으로 늘리고 오픈 추적을 활성화해줘"
주요 파라미터:
id(필수) -- 캠페인 UUID- 다음 중 조합:
name,campaign_schedule,email_list,sequences,daily_limit,email_gap,stop_on_reply,open_tracking,link_tracking등 - 파라미터를
null로 설정하면 해당 값이 해제됩니다
4. 리드 목록 관리 및 대량 가져오기
전용 리드 목록을 생성하고 캠페인 타겟팅을 위해 잠재 고객을 대량으로 가져옵니다.
툴: INSTANTLY_CREATE_LEAD_LIST, INSTANTLY_ADD_LEADS_BULK
예시 프롬프트:
"'Q1 Prospects'라는 리드 목록을 만들고 50개의 리드를 내 Instantly 캠페인에 추가해줘"
리드 목록 생성 주요 파라미터:
- 목록 이름 및 구성
대량 리드 가져오기 주요 파라미터:
- 가져올 캠페인 또는 목록 ID
- 이메일 및 메타데이터가 포함된 리드 객체 배열
- 중복 처리 옵션
- 리드 확인 설정
5. 캠페인 상세 정보 조회
전체 캠페인 구성을 확인하여 설정을 검증하고, 시퀀스를 검사하거나 업데이트 준비를 합니다.
툴: INSTANTLY_GET_CAMPAIGN
예시 프롬프트:
"내 Instantly 캠페인의 전체 세부 정보를 보여줘"
주요 파라미터:
id(필수) -- 캠페인 UUID
6. 모든 캠페인 목록 조회
워크스페이스의 모든 캠페인을 선택적 필터와 페이지네이션과 함께 나열합니다.
툴: INSTANTLY_LIST_CAMPAIGNS
예시 프롬프트:
"내 모든 Instantly 캠페인을 나열해줘"
주요 파라미터:
- 선택적 필터 및 페이지네이션 파라미터
알려진 문제점
- 타임존 지원이 제한적입니다: Instantly API는 제한된 타임존 문자열만 허용합니다. 태평양 표준시 ("America/Los_Angeles")는 지원되지 않습니다. 대안으로 "America/Anchorage" (UTC-9/UTC-8) 또는 "America/Dawson" (연중 UTC-7)을 사용하세요.
- 잘못된 일정 페이로드는 400 오류를 유발합니다:
campaign_schedule이 잘못 구성되면 (days,from,to또는schedules누락) HTTP 400이 발생합니다. 반복적인 400 오류는 일시적 오류가 아닌 페이로드 문제를 나타냅니다. - 시퀀스는 완전해야 합니다: 각 시퀀스 단계에는 유효한
type("email"),delay및 최소 하나의subject와body를 모두 포함하는 변형이 필요합니다. 불완전한 변형은 캠페인 생성을 차단합니다. - 시퀀스의 첫 번째 요소만 사용됩니다: API는
sequences[0]만 처리합니다. 추가 시퀀스는 무시됩니다. email_list는 기존 계정을 참조해야 합니다:email_list필드는 Instantly 워크스페이스에 미리 구성된 발신 계정의 이메일 주소가 필요하며, 임의의 수신자 주소가 아닙니다. 항상INSTANTLY_LIST_ACCOUNTS를 사용하여 유효한 발신 주소를 확인하세요.- 캠페인 생성 시 401 범위 오류: 캠페인 생성이 "Invalid scope. Required: campaigns:create" 오류로 실패할 수 있습니다. 다시 시도하기 전에 API 키 권한을 업데이트하세요.
- 읽기 결과의 필드 이름이 다를 수 있습니다:
INSTANTLY_GET_CAMPAIGN응답의 필드 이름은 생성 페이로드와 다를 수 있습니다 (예:timing.from_vstiming.from). 방어적으로 파싱하세요.
빠른 참조
| 작업 | 툴 슬러그 | 필수 파라미터 |
|---|---|---|
| 발신 계정 목록 조회 | INSTANTLY_LIST_ACCOUNTS | 없음 (선택적 필터) |
| 캠페인 생성 | INSTANTLY_CREATE_CAMPAIGN | name, campaign_schedule |
| 캠페인 업데이트 | INSTANTLY_UPDATE_CAMPAIGN | id |
| 캠페인 상세 정보 조회 | INSTANTLY_GET_CAMPAIGN | id |
| 캠페인 목록 조회 | INSTANTLY_LIST_CAMPAIGNS | 없음 (선택적 필터) |
| 리드 목록 생성 | INSTANTLY_CREATE_LEAD_LIST | 목록 이름 |
| 대량 리드 가져오기 | INSTANTLY_ADD_LEADS_BULK | 캠페인/목록 ID, 리드 |
Composio 제공