WhatsApp 비즈니스 계정을 ElevenLabs Agents와 연결하세요
개요
WhatsApp 비즈니스 계정을 ElevenLabs 에이전트에 연결할 수 있습니다. 그러면 에이전트가 다음을 처리할 수 있습니다.
다른 채널의 에이전트도 WhatsApp 도구를 통해 WhatsApp 메시지를 보낼 수 있습니다.
ElevenLabs의 WhatsApp을 처음 사용하시나요? 시작 가이드를 따라 해 보세요.
WhatsApp 비즈니스 계정 가져오기
에이전트 할당
계정 가져오기를 완료하면 설정 페이지로 이동하며, 여기에서 계정에 에이전트를 할당할 수 있습니다.
계정에 에이전트를 할당하지 않으면 수신 메시지는 무시되고 수신 통화는 거절됩니다. 단, 발신 통화는 계속할 수 있습니다.
WhatsApp Manager 구성
WhatsApp Manager로 이동하여 다음을 설정하세요.
- 프로필 사진 등 설정: 전화번호 페이지를 열고 전화번호를 선택한 후 프로필 탭으로 이동합니다.
- 음성 통화 허용: 전화번호 페이지를 열고 전화번호를 선택한 후 통화 설정 탭으로 이동합니다.
- 발신 통화를 하려면 결제 수단 추가: 개요 페이지를 열고 결제 수단 추가 버튼을 클릭합니다.
계정 설정
가져온 각 번호에는 에이전트 동작을 제어하는 설정이 있습니다.
- 메시지 활성화 — 에이전트가 메시지에 응답할지 여부입니다. 이를 끄면 자체 애플리케이션에서 메시지를 처리하고 ElevenLabs는 통화만 처리하도록 할 수 있습니다.
- 오디오 메시지 응답 활성화 — 켜져 있으면(기본값) 에이전트가 음성 메모에 음성 메모로 응답하고, 꺼져 있으면 항상 텍스트로 응답합니다.
- 입력 표시기 활성화 — 켜져 있으면(기본값) 에이전트가 수신 메시지를 읽음으로 표시하고 응답을 작성하는 동안 입력 표시기를 보여 줍니다.
메시지 대화
WhatsApp 메시지 대화는 에이전트가 대화 종료 시스템 도구를 사용하거나, 설정된 _최대 대화 시간 _ 이 경과하거나, 에이전트의 가장 최근 응답 후 기본 비활성 타임아웃이 경과하면 종료됩니다.
WhatsApp 메시지 대화의 기본 비활성 타임아웃은 에이전트의 가장 최근 응답 시점부터 측정하여 15분입니다. 대화 타임아웃에 대해 자세히 알아보세요.
수신
WhatsApp 비즈니스 계정으로 메시지를 보내면 에이전트가 응답합니다.
타임아웃 중 하나가 만료되면 ElevenAgents는 대화를 종료하기 전에 설정된 _최대 대화 시간 메시지 _ 를 보냅니다. 메시지가 비어 있으면 작별 인사 없이 대화가 종료됩니다.
에이전트는 일반 텍스트 외의 형식도 이해합니다.
- 인용 답장 — 사용자가 메시지를 길게 누르고 답장하면, 에이전트는 어떤 메시지에 응답하는지 알 수 있습니다.
- 리액션 — 에이전트 메시지에 대한 이모지 리액션이 에이전트에 전달됩니다.
- 템플릿 버튼 탭 — 사용자가 템플릿의 빠른 답장 버튼을 탭하면 에이전트는 선택한 버튼을 확인합니다.
- 대화형 답장 — 대화형 버튼 및 목록을 탭하면 선택한 옵션이 전달됩니다.
에이전트는 들어오는 각 메시지에 개별적으로 응답합니다. 빠르게 연속해서 전송된 메시지는 하나의 답장으로 묶이지 않습니다.
발신
대시보드 또는 API에서 Meta 승인 메시지 템플릿을 보내 대화를 시작하고, 통화 권한 요청으로 발신 통화를 예약할 수 있습니다. 템플릿 생성, 코드 예시, 수신자 형식 규칙, 일괄 캠페인에 대해서는 발신 메시지 및 템플릿을 참조하세요.
메시지 유형
텍스트 외에도 다음을 보낼 수 있습니다.
- 오디오
- 수신 음성 메모는 에이전트에 전달되기 전에 텍스트로 변환됩니다.
- 기본적으로 에이전트는 음성 메모에 에이전트에 설정된 음성으로 생성된 음성 메모로 응답합니다. 어떤 음성이든, 어떤 언어든 가능합니다. 항상 텍스트로 응답하려면 계정 설정에서 오디오 메시지 응답 활성화 를 끄세요. 오디오 생성에 실패하면 에이전트는 텍스트 답장으로 대체합니다.
- 오디오 메시지에는 음성 인식 및 텍스트 음성 변환에 대한 추가 요금이 발생합니다. 가격은 STT 및 TTS API와 동일합니다.
- 이미지
- 문서
- 스티커
- 위치
- 연락처
통화
수신
WhatsApp 비즈니스 계정으로 전화를 걸면 에이전트가 응답합니다. 통화 중에도 텍스트 메시지를 보낼 수 있으며, 대화에 반영됩니다.
발신
발신 통화에는 템플릿을 통해 요청하는 사용자 권한이 필요합니다. 흐름, 코드 예시, 일괄 통화에 대해서는 발신 통화 예약을 참조하세요.
개인화
{{system__caller_id}} 및 {{system__called_number}} 동적 변수는 WhatsApp 사용자 ID와 WhatsApp 전화번호 ID로 설정됩니다(또는 누가 대화를 시작했는지에 따라 반대가 될 수 있습니다). 도구 또는 대화 시작 웹훅에서 이를 사용해 대화 중인 사용자 정보를 가져올 수 있습니다.
WhatsApp 페이지로 이동해 계정 옆 메뉴를 클릭하고 전화번호 ID 복사 를 선택하면 WhatsApp 전화번호 ID를 확인할 수 있습니다.
초기화 컨텍스트
에이전트가 위의 시스템 변수 외에 동적 변수를 사용한다면, 해당 값의 출처를 계획해야 합니다. 에이전트가 동적 변수를 사용하지 않는다면 이 내용은 적용되지 않습니다.
수신 대화 는 사용자가 제공한 동적 변수 없이 시작됩니다. 값을 제공하는 지원 방식은 대화 시작 웹훅입니다. WhatsApp 메시지가 대화를 시작하면 ElevenAgents는 WhatsApp 사용자 ID를 caller_id로, WhatsApp 전화번호 ID를 called_number로 하여 엔드포인트를 호출하고, 응답이 반환한 동적 변수를 적용합니다. 웹훅은 에이전트에 필요한 모든 변수를 항상 반환해야 합니다. CRM 값이 있으면 그 값을, 없으면 대체 상수를 반환하세요.
에이전트 편집기의 동적 변수 아래에 입력한 값은 에이전트를 미리 보기 위한 테스트 자리표시자입니다. 프로덕션에서는 사용되지 않으며 수신 대화의 기본값으로도 작동하지 않습니다.
발신 대화 는 발신 메시지 또는 통화 요청의 conversation_initiation_client_data.dynamic_variables 필드에서 값을 받습니다. 이 값은 대화 내내 유지되며 사용자가 답장할 때도 계속 사용할 수 있습니다. 템플릿 매개변수는 별도의 필드이며 동적 변수를 채우지 않습니다.
값이 없는 필수 변수는 대화 실패를 유발합니다. 문제 해결 가이드의 누락된 동적 변수를 참조하세요.
system__called_number 값은 전화번호 자체가 아니라 WhatsApp 전화번호 ID 입니다.
WhatsApp 사용자 식별자도 비즈니스 범위 사용자 ID
(BSUID)로 이전되고 있습니다.
ElevenAgents는 BSUID를 지원하므로 Meta가 사용자 전화번호 대신 ID를 제공하는 경우에도 대화가
작동합니다.
제한 사항
현재 다음 기능은 지원되지 않습니다.
- WhatsApp Flows — 대화형 양식을 보낼 수 없으며, Flow 답장도 에이전트에 전달되지 않습니다.
- 비디오 메시지 — 수신 비디오는 에이전트에 전달되지 않습니다.
- 메시지 일괄 처리 — 에이전트는 빠르게 연속해서 전송된 메시지를 하나로 합치는 대신 각 메시지에 개별적으로 답장합니다.
- 다른 제공업체가 관리하는 번호 — 다른 WhatsApp 제공업체에 등록되었거나 WhatsApp Business 앱에서 활성화된 번호는 가져올 수 없습니다. Multi-Solution Conversations를 지원하기 위해 Meta와 협력하고 있습니다. 음성 전용 설정은 이미 SIP를 통해 가능할 수 있습니다(FAQ 참조).
- 개발자 앱에서 생성된 WABA — 표준 흐름을 통해 가져올 수 없습니다.
- 광고 추천 메타데이터 — Click-to-WhatsApp 광고 기여 데이터는 에이전트에 제공되지 않습니다(FAQ 참조).
- 상담원 인계 — 곧 제공 예정입니다(FAQ 참조).
FAQ
가격, 다중 제공업체 설정, 상담원 인계, Zero-Retention Mode, OTP, 규정 준수와 관련된 일반적인 질문은 문제 해결 및 FAQ에서 확인할 수 있습니다.