Customer.io 자동화
고객 참여 작업을 자동화합니다. 타겟 브로드캐스트 트리거, 전달 지표 조회, 오디언스 세그먼트 관리, 뉴스레터 및 트랜잭셔널 템플릿 목록 확인, 트리거 실행 내역 검사 등을 Composio MCP 통합을 통해 오케스트레이션합니다.
툴킷 문서: composio.dev/toolkits/customerio
설정
- Composio MCP 서버(
https://rube.app/mcp)를 통해 Customer.io 계정을 연결합니다. - 활성 연결이 없으면 에이전트가 인증 링크를 제공합니다.
- 연결이 완료되면 모든
CUSTOMERIO_*툴을 사용할 수 있습니다.
핵심 워크플로우
1. 브로드캐스트 트리거
사전 구성된 브로드캐스트를 특정 오디언스에 개인화 데이터와 함께 수동으로 실행합니다.
툴: CUSTOMERIO_TRIGGER_BROADCAST
| 파라미터 | 유형 | 필수 | 설명 |
|---|---|---|---|
broadcast_id | 정수 | 예 | Customer.io 트리거링 세부정보의 브로드캐스트 ID |
ids | 배열 | 아니요 | 타겟팅할 고객 ID 목록 |
emails | 배열 | 아니요 | 타겟팅할 이메일 주소 목록 |
recipients | 객체 | 아니요 | and/or/not/segment 연산자를 사용한 복합 필터 |
per_user_data | 배열 | 아니요 | id/email + data를 포함한 사용자별 개인화 |
data | 객체 | 아니요 | Liquid 템플릿 개인화를 위한 전역 키-값 데이터 |
data_file_url | 문자열 | 아니요 | 줄별 사용자 데이터가 포함된 JSON 파일 URL |
email_add_duplicates | 부울 | 아니요 | 중복 수신자 허용 (기본값: false) |
email_ignore_missing | 부울 | 아니요 | 이메일 없는 사용자 건너뛰기 (기본값: false) |
id_ignore_missing | 부울 | 아니요 | 고객 ID 없는 사용자 건너뛰기 (기본값: false) |
중요: recipients, ids, emails, per_user_data, data_file_url 중 정확히 하나의 오디언스 옵션만 제공하세요. 속도 제한: 브로드캐스트당 10초에 1회 요청.
2. 메시지 전달 지표 조회
캠페인, 유형, 시간 범위로 필터링하여 메시지의 페이지네이션된 전달 지표를 가져옵니다.
툴: CUSTOMERIO_GET_MESSAGES
| 파라미터 | 유형 | 필수 | 설명 |
|---|---|---|---|
type | 문자열 | 아니요 | 메시지 유형: email, webhook, twilio, slack, push, in_app |
metric | 문자열 | 아니요 | 지표: attempted, sent, delivered, opened, clicked, converted |
campaign_id | 정수 | 아니요 | 캠페인 ID로 필터링 |
newsletter_id | 정수 | 아니요 | 뉴스레터 ID로 필터링 |
action_id | 정수 | 아니요 | 액션 ID로 필터링 |
start_ts | 정수 | 아니요 | 시간 창 시작 (Unix 타임스탬프) |
end_ts | 정수 | 아니요 | 시간 창 종료 (Unix 타임스탬프) |
limit | 정수 | 아니요 | 페이지당 결과 수, 1-1000 (기본값: 50) |
start | 문자열 | 아니요 | 이전 응답 next 값의 페이지네이션 토큰 |
drafts | 부울 | 아니요 | 활성/전송된 메시지 대신 초안 메시지 반환 |
3. 오디언스 세그먼트 목록 조회
워크스페이스에 정의된 모든 세그먼트를 조회하여 오디언스 분석 및 브로드캐스트 타겟팅에 활용합니다.
툴: CUSTOMERIO_GET_SEGMENTS
필요한 파라미터 없음 – 모든 세그먼트를 ID와 메타데이터와 함께 반환합니다.
브로드캐스트 타겟팅 시 recipients.segment.id 필터를 통해 해당 세그먼트 ID를 사용합니다.
4. 뉴스레터 목록 조회
추적 및 분석을 위해 모든 뉴스레터 메타데이터를 페이지네이션합니다.
툴: CUSTOMERIO_LIST_NEWSLETTERS
| 파라미터 | 유형 | 필수 | 설명 |
|---|---|---|---|
limit | 정수 | 아니요 | 페이지당 최대 항목 수, 1-100 |
sort | 문자열 | 아니요 | asc (시간순) 또는 desc (역순) |
start | 문자열 | 아니요 | 이전 응답 next 값의 페이지네이션 커서 |
5. 트랜잭셔널 메시지 템플릿 검색
모든 트랜잭셔널 메시지 템플릿을 나열하여 API를 통해 전송할 수 있는 ID를 찾습니다.
툴: CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES
필요한 파라미터 없음 – 템플릿 ID와 트리거 이름을 반환합니다.
6. 브로드캐스트 트리거 실행 기록 검사
브로드캐스트의 모든 트리거 실행을 검토하고 개별 트리거 세부정보를 확인합니다.
툴: CUSTOMERIO_GET_TRIGGERS 및 CUSTOMERIO_GET_TRIGGER
브로드캐스트의 모든 트리거 목록 조회:
| 파라미터 | 유형 | 필수 | 설명 |
|---|---|---|---|
broadcast_id | 정수 | 예 | 브로드캐스트/캠페인 ID |
특정 트리거 조회:
| 파라미터 | 유형 | 필수 | 설명 |
|---|---|---|---|
broadcast_id | 정수 | 예 | 캠페인/브로드캐스트 ID |
trigger_id | 문자열 | 예 | 트리거 식별자 (예: 456 또는 5-37) |
알려진 문제점
| 문제점 | 세부내용 |
|---|---|
| 상호 배타적 오디언스 파라미터 | CUSTOMERIO_TRIGGER_BROADCAST는 recipients, ids, emails, per_user_data, data_file_url 중 정확히 하나만 필요합니다. 여러 개를 제공하면 오류가 발생합니다. |
| 브로드캐스트 속도 제한 | 브로드캐스트는 브로드캐스트 ID당 10초에 1회의 트리거 요청으로 제한됩니다. |
| Unix 타임스탬프 형식 | CUSTOMERIO_GET_MESSAGES의 start_ts와 end_ts는 ISO 문자열이 아닌 Unix 타임스탬프여야 합니다. |
| 페이지네이션 토큰 | 메시지와 뉴스레터는 start 파라미터를 통해 커서 기반 페이지네이션을 사용합니다. 이전 응답의 next 값을 사용하세요. |
| 세그먼트 ID 확인 | 브로드캐스트에서 세그먼트를 타겟팅하려면 먼저 CUSTOMERIO_GET_SEGMENTS로 세그먼트 ID를 가져온 후 recipients.segment.id에서 ID로 참조하세요. |
빠른 참조
| 툴 슬러그 | 목적 |
|---|---|
CUSTOMERIO_TRIGGER_BROADCAST | 정의된 오디언스에 브로드캐스트 트리거 |
CUSTOMERIO_GET_MESSAGES | 필터가 포함된 메시지 전달 지표 조회 |
CUSTOMERIO_GET_SEGMENTS | 모든 오디언스 세그먼트 목록 조회 |
CUSTOMERIO_GET_SEGMENT_DETAILS | 특정 세그먼트의 세부정보 조회 |
CUSTOMERIO_LIST_NEWSLETTERS | 뉴스레터 페이지네이션 |
CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES | 트랜잭셔널 메시지 템플릿 목록 |
CUSTOMERIO_GET_TRIGGERS | 브로드캐스트의 모든 트리거 실행 목록 |
CUSTOMERIO_GET_TRIGGER | 특정 트리거 실행 검사 |
Composio 제공