Brevo | ElevenLabs Documentation

리셉셔니스트는 Brevo를 통해 발신자에게 문자 메시지를 보낼 수 있습니다. 예를 들어 주소나 통화에서 합의한 내용의 요약을 보낼 수 있습니다. 웹훅 도구가 SMS를 전송합니다. 연락처를 조회하고 저장하려면 Brevo의 MCP 서버를 연결하세요.

통화 중 메시지를 요청하거나 수신에 동의한 발신자에게만 문자를 보내고, 이 메시지는 거래성 메시지로 유지하세요. 프로모션은 보내면 안 됩니다. 마케팅 문자는 미국의 TCPA 및 EU의 GDPR과 같은 규정에 따라 사전 동의와 수신 거부 방법이 필요합니다. 활성화하기 전에 비즈니스에 적용되는 규정을 확인하세요.

후속 문자 보내기

Brevo 계정 준비하기

SMS에는 선불 크레딧이 사용됩니다. Brevo에서 SMS 크레딧을 구매하고 문자를 보낼 국가에서 SMS 발송을 사용할 수 있는지 확인하세요. 미국과 캐나다 등 일부 국가에서는 사용자 지정 발신자 이름을 허용하지 않습니다.

API 키 만들기

Brevo에서 SMTP & API → API Keys를 열고 Generate a new API key를 선택합니다. 이 키에서는 Create MCP server API key를 끈 상태로 둡니다. xkeysib-로 시작하는 키를 복사합니다.

웹훅 도구 만들기

Integrations로 이동한 다음 Add integration을 선택하고 Webhook Tool을 선택합니다.

필드	값
Name	`send_followup_text`
Description	”발신자에게 문자 메시지를 보냅니다. 발신자가 문자를 요청하거나 수신에 동의한 경우에만 사용하세요. 프로모션은 절대 보내지 마세요.”
Method	POST
URL	`https://api.brevo.com/v3/transactionalSMS/send`
Request Headers	`api-key`: API 키 `accept`: `application/json`
Body Parameters	`sender` (문자열, 필수): “항상 정확히 `YOUR_SENDER` 값을 사용합니다.” `recipient` (문자열, 필수): “국가 코드가 포함된 발신자의 휴대전화 번호입니다. 숫자만 사용하고 `+` 또는 공백은 제외합니다. 예: 14155550123.” `content` (문자열, 필수): “160자 미만의 문자 메시지입니다. 비즈니스 이름으로 시작합니다.” `type` (문자열, 필수): “항상 정확히 `transactional` 값을 사용합니다.”
Assign to agents	Receptionist

YOUR_SENDER를 발신자 이름(영문자와 숫자 최대 11자) 또는 발신 번호(최대 15자리)로 바꾸세요.

테스트하기

Enable을 선택한 후, 본인의 휴대전화 번호를 사용해 주소를 문자로 요청하여 리셉셔니스트를 테스트하세요. Brevo의 SMS 로그에서 전송 상태를 확인할 수 있습니다.

160자를 초과하는 메시지는 여러 문자로 나뉘어 전송되며, 각 메시지에 크레딧이 사용됩니다.

연락처 조회 및 저장

MCP 키 만들기

Brevo에서 SMTP & API → API Keys를 열고 Generate a new API key를 선택한 다음 Create MCP server API key를 켭니다. 키를 복사합니다.

MCP 키는 Brevo 계정에 대한 전체 읽기 및 쓰기 권한을 가집니다. SMS 키와 별도로 보관하고 아래의 연락처 모듈만 연결하세요.

MCP 서버 추가하기

Reception.ai에서 Integrations로 이동한 다음 Add integration을 선택하고 MCP Server를 선택합니다.

필드	값
Name	Brevo 연락처
Server type	Streamable HTTP
Server URL	`https://mcp.brevo.com/v1/brevo_contacts/mcp`
Secret Token	MCP 키

Enable을 선택합니다. Reception.ai가 키를 베어러 토큰으로 전송하고 Brevo의 연락처 도구를 표시합니다.

도구 할당하기

Tools 탭을 엽니다. 연락처를 조회하고 생성하는 도구를 Client(리셉셔니스트)에 할당합니다. 연락처를 삭제하거나 목록을 변경하는 도구는 할당하지 않거나 Assistant에만 할당하세요.

https://mcp.brevo.com/v1/brevo/mcp는 이메일 캠페인을 포함한 모든 Brevo 모듈을 노출합니다. 팀이 Assistant에서 캠페인을 관리하도록 하려는 경우에만 사용하세요.

문제 해결

문제	확인할 사항
Brevo가 401을 반환함	헤더 이름은 반드시 `api-key`여야 합니다. Brevo에서 인식되지 않은 IP 주소를 언급하면 Brevo 보안 설정의 승인된 IP를 확인하세요.
Brevo가 400을 반환함	번호에 국가 코드가 있고 `+`가 없는지, 발신자 이름이 최대 11자인지 확인하세요.
문자가 도착하지 않음	SMS 크레딧과 해당 국가로 현재 발신자를 사용해 Brevo가 SMS를 보낼 수 있는지 확인하세요.
MCP 도구가 표시되지 않음	Streamable HTTP와 SMS 키가 아닌 MCP 키를 사용하세요.
MCP 키를 변경함	연동을 수정하고 Rotate Secret Token (optional) 을 사용하세요. 저장된 토큰은 다시 표시되지 않습니다.