Migracja z innego dostawcy

1. Zmapuj wywołanie wysyłki na POST /v1/email/messages
2. Przekieruj domeny wysyłkowe i DNS
3. Zaimportuj listę blokad
4. Przełącz webhooki na nasze słownictwo zdarzeń
5. Zweryfikuj w sandboxie pocztowym przed przełączeniem

1. Zmapuj wywołanie wysyłki

• Planowanie, zapisane szablony i załączniki przenoszą się bezproblemowo. Użyj scheduled_at do planowanej wysyłki. Użyj template zamiast treści inline dla zapisanych szablonów. Zmapuj pliki na tablicę załączników.
• Zablokowane adresy są odrzucane w widoczny sposób. Zablokowany adres wciąż otrzymuje recipient_id i pojawia się na liście odbiorców wiadomości ze statusem rejected oraz zdarzeniem email.rejected (rejection_reason: recipient_suppressed), nigdy jako cicha utrata. Nawet gdy wszyscy odbiorcy są zablokowani, żądanie jest akceptowane z 202. Każdy odbiorca wraca jako odrzucony. Zobacz Blokady.
• Ustaw category: "transactional" dla poczty operacyjnej. Domyślna wartość wysyłki to marketing, a kategoria kontroluje politykę blokad: marketing blokuje na podstawie skarg i wypisań, transactional dostarcza mimo nich. Newslettery i kampanie są obsługiwane poprawnie przez wartość domyślną. Oznacz potwierdzenia, resety haseł i podobną pocztę operacyjną jako transactional, aby nie były blokowane przez wypisanie.

2. Przekieruj domeny i DNS

3. Zaimportuj listę blokad

while read -r address; do
  curl -s -X POST https://us1.platform.bird.com/v1/email/suppressions \
    -H "Authorization: Bearer $BIRD_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"email\": \"$address\"}"
done < suppressions.txt

• Importujesz jeden adres na żądanie. API blokad to CRUD dla pojedynczych wpisów, więc duża lista oznacza iterację po wyeksportowanych adresach. Wywołanie jest idempotentne (201 dla nowego rekordu, 200 z istniejącym rekordem, jeśli adres jest już ręcznie zablokowany), więc ponowne uruchomienie częściowego importu jest bezpieczne.
• Zaimportowane adresy otrzymują reason: manual, applies_to: all, co blokuje każdą kategorię, w tym transakcyjną. To surowsze niż natywny rekord skargi, który blokuje tylko wysyłki nietransakcyjne, więc jeśli potrzebujesz zachowania zależnego od kategorii dla konkretnych adresów, zobacz taksonomię przyczyn w Blokady.

4. Przełącz webhooki

5. Zweryfikuj w sandboxie przed przełączeniem

1. Wyślij na delivered@messagebird.dev i sprawdź, czy Twój handler przetwarza email.accepted → email.processed → email.delivered.
2. Wyślij na bounce@messagebird.dev i sprawdź, czy Twoja obsługa odbić reaguje na email.bounced (symulowane odbicia nie zapisują do Twojej listy blokad, więc adres pozostaje wielokrotnego użytku).
3. Wyślij na suppressed@messagebird.dev i sprawdź, czy obsługujesz email.accepted, a po nim email.rejected, bez email.processed ani zdarzeń dostarczenia po nim. Taki kształt generuje każdy zablokowany odbiorca w produkcji; szczegóły rejection_reason: recipient_suppressed znajdują się w rekordzie odbiorcy i zdarzeniach API.
4. Wyślij wiadomość category: "marketing" i potwierdź, że kategoria pojawia się tam, gdzie oczekujesz, w odczycie wiadomości.

Migracja z konkretnego dostawcy

• SendGrid: personalizations → płaski payload, categories/custom_args → tags/metadata, równoważność dropped ↔ email.rejected
• Mailgun: parametry o:*/v:*/h:* → pola pierwszej klasy, eksport odbić/skarg/wypisań
• Amazon SES: SendEmail v2 → jeden endpoint, zestawy konfiguracji → flagi śledzenia per wiadomość, SNS → podpisane webhooki
• Resend: niemal identyczny kształt payloadu, webhooki podpisane przez Svix → Standard Webhooks
• Postmark: odbiorcy oddzieleni przecinkami → tablice, zrzuty blokad per strumień, niepodpisane webhooki → podpisane
• Brevo: obiekty adresów → zwykłe adresy, dwie osobne listy blokad do wyeksportowania, params → template.parameters
• MailerSend: pięć list blokad, z których tymczasowa zostaje u dostawcy, personalization → parametry per wysyłkę
• Mailjet: tablica Messages → jeden płaski payload, EventPayload → metadata, eksport listy blokad
• Mandrill: wrapper message i uwierzytelnianie w ciele → płaski payload i uwierzytelnianie bearer, eksport blacklisty odrzuceń

Kolejne kroki

• Wysyłanie e-maili: pełny payload wysyłki, tagi vs metadane, asynchroniczny model 202
• Domeny wysyłkowe: rejestracja, cykl życia weryfikacji, konfiguracja wieloregionowa
• DKIM, SPF & DMARC: co dowodzi każdy rekord i dlaczego SPF w apeksie nie jest wymagany
• Blokady: przyczyny, kategorie i API zarządzania
• Webhooki i zdarzenia: konfiguracja endpointu, weryfikacja Standard Webhooks, ponowne próby i powtórki
• Zdarzenia: schematy payloadów poszczególnych zdarzeń
• Sandbox testowy: pełna lista magicznych adresów i instrukcje krok po kroku
• Dokumentacja API: schematy żądań i odpowiedzi dla endpointu wysyłki