Omnisend 자동화
이커머스 마케팅 운영을 자동화하세요 — 연락처 생성 및 업데이트, 커서 페이지네이션을 이용한 구독자 목록 관리, 대량 배치 작업 실행, 그리고 대상 그룹 세분화 등 모든 작업이 Composio MCP 통합을 통해 조정됩니다.
툴킷 문서: composio.dev/toolkits/omnisend
설정
https://rube.app/mcp에서 Composio MCP 서버를 통해 Omnisend 계정을 연결하세요.- 활성 연결이 없으면 에이전트가 인증 링크를 제공합니다.
- 연결이 완료되면 모든
OMNISEND_*도구를 실행할 수 있습니다.
핵심 워크플로우
1. 연락처 생성 또는 업데이트
이메일 식별자로 연락처를 Upsert하고 구독 상태, 프로필 필드, 선택적 환영 메시지를 설정합니다.
도구: OMNISEND_CREATE_OR_UPDATE_CONTACT
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
identifiers | array | 예 | 최소 하나의 식별자 객체 필요. id (이메일), type (email), 선택적 channels.email.status (subscribed, nonSubscribed, unsubscribed), sendWelcomeMessage (boolean) 포함 |
firstName | string | 아니오 | 연락처의 이름 |
lastName | string | 아니오 | 연락처의 성 |
gender | string | 아니오 | m 또는 f |
birthdate | string | 아니오 | 형식: YYYY-MM-DD |
country | string | 아니오 | 전체 국가명 |
countryCode | string | 아니오 | ISO 3166-1 alpha-2 코드 (예: US) |
city | string | 아니오 | 도시명 |
address | string | 아니오 | 거리 주소 |
postalCode | string | 아니오 | 우편번호 |
2. 연락처 목록 조회 (페이지네이션)
이메일, 전화번호, 상태, 세그먼트, 또는 태그로 필터링하여 연락처를 배치 단위로 조회합니다.
도구: OMNISEND_LIST_CONTACTS
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
limit | integer | 아니오 | 페이지당 결과 수 (기본값: 100, 최대: 250) |
after | string | 아니오 | 다음 페이지 커서 (base64로 인코딩된 ContactID) |
before | string | 아니오 | 이전 페이지 커서 |
email | string | 아니오 | 정확한 이메일 주소로 필터링 |
phone | string | 아니오 | 국가 코드를 포함한 전체 전화번호로 필터링 |
status | string | 아니오 | subscribed, nonSubscribed, unsubscribed 중 선택 |
segmentID | integer | 아니오 | 세그먼트 ID로 필터링 |
tag | string | 아니오 | 태그로 필터링 (예: VIP) |
3. 연락처 상세 정보 조회
이미 연락처 ID를 알고 있을 때 단일 연락처의 전체 프로필을 조회합니다.
도구: OMNISEND_GET_CONTACT
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
contactId | string | 예 | 고유 연락처 식별자 (예: 60e7412b1234567890abcdef) |
4. 기존 연락처 업데이트
ID로 특정 필드를 패치하여 전체 레코드를 덮어쓰지 않고 업데이트합니다.
도구: OMNISEND_UPDATE_CONTACT
contactId와 업데이트할 필드가 필요합니다. OMNISEND_LIST_CONTACTS 또는 OMNISEND_GET_CONTACT를 통해 먼저 연락처 ID를 확인하세요.
5. 대량 배치 작업
단일 호출로 많은 레코드를 비동기식으로 처리합니다. 연락처, 상품, 주문, 이벤트, 또는 카테고리를 대상으로 합니다.
도구: OMNISEND_CREATE_BATCH
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
method | string | 예 | POST 또는 PUT |
endpoint | string | 예 | 대상: contacts, orders, products, events, categories |
items | array | 예 | 각 작업에 대한 페이로드 객체 배열 |
eventID | string | 조건부 | 엔드포인트가 events일 때 필수 |
대량 데이터 처리 시 속도 제한을 피하려면 배치 작업을 활용하세요.
알려진 문제점
| 문제점 | 세부 사항 |
|---|---|
| 식별자 필수 | OMNISEND_CREATE_OR_UPDATE_CONTACT는 identifiers 배열에 최소 하나의 식별자가 필요합니다. email 유형만 지원됩니다. |
| 커서 기반 페이지네이션 | OMNISEND_LIST_CONTACTS는 페이지 번호가 아닌 base64로 인코딩된 after/before 커서를 사용합니다. 불완전한 데이터를 방지하려면 커서를 따라야 합니다. |
| 연락처 ID 확인 | OMNISEND_UPDATE_CONTACT는 contactId가 필요합니다. 목록 또는 조회 작업을 통해 먼저 ID를 확인하세요. |
| 배치 메서드 제약 | OMNISEND_CREATE_BATCH는 POST 또는 PUT 메서드만 허용합니다. DELETE나 PATCH는 지원하지 않습니다. |
| 이벤트 ID 의존성 | 이벤트를 배치 처리할 때 eventID 매개변수가 필수입니다. 생략하면 배치가 실패합니다. |
빠른 참조
| 도구 슬러그 | 용도 |
|---|---|
OMNISEND_CREATE_OR_UPDATE_CONTACT | 이메일로 연락처 생성 또는 Upsert |
OMNISEND_LIST_CONTACTS | 필터링 및 커서 페이지네이션으로 연락처 목록 조회 |
OMNISEND_GET_CONTACT | ID로 단일 연락처 전체 프로필 조회 |
OMNISEND_UPDATE_CONTACT | 기존 연락처의 특정 필드 패치 |
OMNISEND_CREATE_BATCH | 연락처, 상품, 주문, 이벤트에 대한 대량 비동기 작업 |
Composio 제공