Walidacja kontaktu WhatsApp z Salesforce

Ilustracja konsoli CRM sprawdzającej cichy telefon przez bezpieczną bramę API i zwracającej status do weryfikacji.

Sam numer telefonu w Salesforce nie mówi zespołowi sprzedaży, czy WhatsApp jest właściwym kanałem. Ręczna kontrola wymaga przejścia do innego narzędzia i nie pozostawia spójnego statusu dla kolejnej osoby ani automatyzacji.

Zbudowaliśmy serwis Apex, który przekazuje znormalizowany numer do Meta WhatsApp Cloud API, interpretuje odpowiedź i zwraca użyteczny wynik do Salesforce.

Wzorzec integracji

Proces ma pięć kroków:

  1. Normalizacja numeru z CRM.
  2. Uwierzytelnione wywołanie HTTP z Apex.
  3. Analiza odpowiedzi i znanych błędów, w tym 131026.
  4. Mapowanie wyniku na dostępny, niedostępny lub wymaga weryfikacji.
  5. Decyzja w Salesforce Flow albo dialogu Einstein Bot.

Ścieżka integracji: kontakt w Salesforce, uwierzytelnione wywołanie HTTP z Apex, odpowiedź Meta API i status zapisany z powrotem w Salesforce

Metoda @InvocableMethod pozwala używać tej samej logiki w wielu Flow. Testy z HttpCalloutMock sprawdzają ścieżki sukcesu i błędów bez zależności od żywego API.

Klasa Apex z InvocableMethod i mapStatus, testowana trzema odpowiedziami HttpCalloutMock

Dlaczego potrzebny jest status „wymaga weryfikacji”

Błąd API nie zawsze dowodzi, że kontakt nigdy nie będzie dostępny. Format numeru, uprawnienia, stan konta oraz chwilowe problemy platformy mogą zmienić wynik. Dobra integracja zapisuje przyczynę obok statusu i nie zamienia niejednoznacznego sygnału w fałszywe tak lub nie.

Router statusów kierujący wynik API do trzech stanów: dostępny, niedostępny i wymaga weryfikacji

Co zostało zweryfikowane

W sandboxie Salesforce potwierdziliśmy callout, parsowanie odpowiedzi, obsługę znanych błędów i zwrot statusu do CRM. Implementacja została opisana jako Ticket 1.

Nie przypisujemy temu case’owi niezmierzonych wyników sprzedażowych. Potwierdzona wartość jest architektoniczna: kontrola działa wewnątrz Salesforce i dostarcza śledzony sygnał dla kolejnych automatyzacji.

Precyzja przy określeniu „cicha walidacja”

To, czy proces jest całkowicie niewidoczny dla odbiorcy, zależy od endpointu Meta, zachowania wiadomości lub szablonu i bieżącej konfiguracji konta. Te warunki trzeba zweryfikować przed obietnicą „zero widocznych wiadomości”.

Jeżeli chcesz sprawdzić ścieżkę integracji CRM, model statusów i obsługę błędów, zamów audyt architektury.