Lemlist 자동화
Lemlist 멀티채널 아웃리치 워크플로우를 자동화합니다. 캠페인 관리, 리드 대량 등록, 사용자 정의 변수 보강, 캠페인 데이터 내보내기, 구독 취소 정리를 수행할 수 있습니다.
툴킷 문서: composio.dev/toolkits/lemlist
설정
- 클라이언트에 Composio MCP 서버 추가:
https://rube.app/mcp - 메시지가 표시되면 Lemlist 계정을 연결합니다 (API 키 인증)
- 아래 워크플로우를 사용하기 시작합니다
핵심 워크플로우
1. 캠페인 목록 조회 및 검색
LEMLIST_GET_LIST_CAMPAIGNS를 사용하여 상태별로 모든 캠페인을 열거하고 페이지네이션을 지원합니다.
도구: LEMLIST_GET_LIST_CAMPAIGNS
입력:
- status: "running" | "draft" | "archived" | "ended" | "paused" | "errors" (선택)
- limit: 정수 (최대 100, 기본값 100)
- offset: 정수 (페이지네이션 오프셋)
- sortBy: "createdAt"
- sortOrder: "asc" | "desc"
중요: 응답이 평면 목록 대신 {campaigns: [...], pagination: {...}} 형태로 래핑될 수 있습니다. 항상 campaigns 키에서 추출하십시오.
2. 캠페인 상세 정보 가져오기
LEMLIST_GET_CAMPAIGN_BY_ID를 사용하여 쓰기 작업 전에 캠페인 구성을 검증합니다.
도구: LEMLIST_GET_CAMPAIGN_BY_ID
입력:
- campaignId: 문자열 (필수) -- 예: "cam_A1B2C3D4E5F6G7H8I9"
3. 캠페인에 리드 등록
LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN을 사용하여 선택적 이메일 찾기, 전화번호 조회, LinkedIn 정보 보강과 함께 리드를 추가합니다.
도구: LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN
입력:
- campaignId: 문자열 (필수)
- email: 문자열 (필수)
- firstName, lastName, companyName, companyDomain: 문자열 (선택)
- jobTitle, phone, linkedinUrl, icebreaker: 문자열 (선택)
- deduplicate: 불리언 (캠페인 간 중복 방지)
- findEmail, findPhone, verifyEmail, linkedinEnrichment: 불리언 (선택)
- timezone: 문자열 (IANA 형식, 예: "America/New_York")
대량 패턴: 리드를 약 50개씩 배치로 나누고 배치 간 진행률을 체크포인트합니다.
4. 리드에 사용자 정의 변수 추가
LEMLIST_POST_ADD_VARIABLES_TO_LEAD를 사용하여 등록 후 리드에 개인화 필드를 보강합니다.
도구: LEMLIST_POST_ADD_VARIABLES_TO_LEAD
입력:
- leadId: 문자열 (필수) -- 내부 Lemlist 리드 ID (이메일 아님)
- company: 문자열 (필수) -- Lemlist의 회사 이름과 일치해야 함
- variables: 객체 (필수) -- 키-값 쌍, 예: {"score": "42", "color": "yellow"}
중요: 이는 업서트가 아닙니다. 이미 존재하는 변수를 추가하려고 하면 실패합니다. 이메일 주소만 있는 경우 LEMLIST_GET_RETRIEVE_LEAD_BY_EMAIL을 통해 내부 leadId를 확인하십시오.
5. 캠페인 리드 내보내기
LEMLIST_GET_EXPORT_CAMPAIGN_LEADS를 사용하여 상태 필터링과 함께 리드를 다운로드하여 보고 또는 QA에 활용합니다.
도구: LEMLIST_GET_EXPORT_CAMPAIGN_LEADS
입력:
- campaignId: 문자열 (필수)
- (상태 필터링 및 JSON/CSV 출력 지원)
6. 캠페인에서 리드 구독 취소
LEMLIST_DELETE_UNSUBSCRIBE_LEAD_FROM_CAMPAIGN을 사용하여 아웃리치를 중단하기 위해 캠페인에서 리드를 제거합니다.
도구: LEMLIST_DELETE_UNSUBSCRIBE_LEAD_FROM_CAMPAIGN
입력:
- campaignId: 문자열 (필수)
- leadId 또는 email: 문자열 (필수)
알려진 함정
| 함정 | 상세 설명 |
|---|---|
| 래핑된 캠페인 목록 | LEMLIST_GET_LIST_CAMPAIGNS가 평면 배열 대신 {campaigns: [...], pagination: {...}}을 반환할 수 있습니다. 항상 campaigns 키에서 추출하십시오. |
| 캠페인 간 중복 제거 | 중복 제거를 활성화한 LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN이 HTTP 500 "Lead already in other campaign" 오류와 함께 실패합니다. 의도적인 캠페인 간 등록의 경우 중복 제거를 비활성화하십시오. |
| 대량 가져오기 실패 | 대량 가져오기를 배치당 약 50개로 나누고 체크포인트를 설정하여 간헐적 실패 시 부분 진행 상황이 손실되지 않도록 하십시오. |
| 잘못된 leadId | LEMLIST_POST_ADD_VARIABLES_TO_LEAD가 leadId로 이메일을 사용할 경우 HTTP 400 "Invalid leadId"를 반환합니다. 먼저 LEMLIST_GET_RETRIEVE_LEAD_BY_EMAIL을 통해 내부 ID를 확인하십시오. |
| 변수 충돌 | LEMLIST_POST_ADD_VARIABLES_TO_LEAD는 업서트가 아닙니다. 이미 존재하는 키를 추가하면 HTTP 400 "Variables X already exist"가 반환됩니다. |
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
LEMLIST_GET_LIST_CAMPAIGNS | 상태 필터 및 페이지네이션으로 모든 캠페인 목록 조회 |
LEMLIST_GET_CAMPAIGN_BY_ID | ID로 상세 캠페인 정보 가져오기 |
LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN | 캠페인에 리드 생성 및 등록 |
LEMLIST_POST_ADD_VARIABLES_TO_LEAD | 리드에 사용자 정의 개인화 변수 추가 |
LEMLIST_GET_RETRIEVE_LEAD_BY_EMAIL | 이메일 주소로 리드 조회 |
LEMLIST_GET_EXPORT_CAMPAIGN_LEADS | 상태 필터링으로 캠페인에서 리드 내보내기 |
LEMLIST_DELETE_UNSUBSCRIBE_LEAD_FROM_CAMPAIGN | 캠페인에서 리드 제거 |
Powered by Composio