CF7-Brevo 통합 시 API Endpoint 분리로 인한 웰컴 메일 누락 해결

CF7 Brevo Integration Adds Contacts But Never Sends the Welcome Email - Here Is Why

Rahul Sharma2026년 6월 22일5분intermediate

AI 요약

Context

CF7의 내장 Brevo 연동 기능이 Contact 생성 API(POST /v3/contacts)만 호출하고 Transactional Email API(POST /v3/smtp/email)를 누락한 설계적 한계 존재. 설정 패널의 웰컴 메일 체크박스가 실제 Transactional Template 호출로 이어지지 않는 기능적 공백 발생.

Technical Solution

wpcf7_before_send_mail Hook을 통한 Custom PHP 함수 구현으로 전송 시점 제어
Brevo Transactional Email Endpoint로의 직접적인 HTTP POST 요청을 통한 메일 발송 강제
wp_remote_post 함수를 활용하여 API Key 및 Template ID를 포함한 JSON Payload 전송
params 객체 설계를 통한 동적 개인화 변수(FIRSTNAME 등) 매핑으로 템플릿 유연성 확보
PHP 구현의 대안으로 API Endpoint 매핑 설정이 가능한 No-Code 인터페이스 도입을 통한 유지보수 비용 절감
Template Status의 Active 여부 검증 단계를 추가하여 API 호출 이후의 발송 실패 가능성 차단

실천 포인트

- 외부 서비스 연동 시 API Endpoint가 기능별로 분리되어 있는지 확인 - 플러그인 내 설정 옵션이 실제 API Request로 변환되는지 네트워크 로그 기반 검증 - Transactional Email 발송 시 Template ID의 Active 상태 설정 여부 우선 체크 - Critical한 알림 메일의 경우 단순 통합 툴보다 Custom Hook을 통한 명시적 API 호출 권장

태그

#API Integration #REST API #Transactional Email #WordPress Hook #Payload Mapping

원문 읽기