Salesforce koppelen
Met het PostBuddy-pakket voor Salesforce kan een flow in je org een kaart versturen, bijvoorbeeld als een opportunity is gewonnen. De status van elke kaart komt terug in een Mail Item-record in Salesforce. Owners, Admins en Developers kunnen Salesforce koppelen; je hebt ook een Salesforce-beheerder nodig.
Koppelen in PostBuddy
- Open Integraties en kies Koppelen op de kaart van Salesforce.
- Vul een Naam in en je Salesforce instance-URL, bijvoorbeeld https://yourcompany.my.salesforce.com.
- Kies de Status-writeback: hoe statusupdates Salesforce bereiken.
- Kies Installeren.
- Kopieer de waarden die verschijnen: de API-sleutel en, bij een writeback, het webhook-secret. Ze worden maar één keer getoond.
| Status-writeback | Hoe het werkt |
|---|---|
| Connected App (aanbevolen) | PostBuddy stuurt elke statuswijziging naar je org. Je vult het Apex REST-endpoint in en de client-id en het client secret van een Connected App. |
| Site-gastgebruiker | PostBuddy stuurt statuswijzigingen naar een openbare Salesforce-site. Alleen de handtekening beschermt die, dus kies liever de Connected App. |
| Pollen vanuit Salesforce (NONE) | Salesforce haalt de updates zelf op met een geplande job. |
Vink Spiegel elk poststuk, niet alleen die vanuit Salesforce zijn gemaakt aan als Salesforce ook kaarten moet tonen die vanuit Postbatches of de API zijn verstuurd.
De setup afronden in Salesforce
Je Salesforce-beheerder doet daarna het volgende:
- Installeert het PostBuddy-pakket in je org en wijst de permission sets toe.
- Voegt de API-sleutel toe als ApiKey-parameter van de PostBuddy API-principal (Setup, Named Credentials).
- Plakt het webhook-secret op het tabblad PostBuddy Setup en draait de verbindingstests.
- Maakt een flow met de actie "Send Mail Item" en de Postflow-id uit het portaal.
Kies daarna in PostBuddy Beheren op de kaart van Salesforce, open de installatie en kies Health check draaien. De status verandert in Gekoppeld als alles werkt.
Probeer je flow eerst in een sandbox, met de invoer voor de testmodus van de actie op true. Testpoststukken worden nooit gedrukt of in rekening gebracht. Zie Een testpoststuk versturen.
De koppeling beheren
Onder Beheren zie je elke gekoppelde org met de status en de laatste activiteit.
- Configureren wijzigt de instellingen van de writeback.
- Uitschakelen stopt de koppeling: poststukken die met de sleutel ervan worden verstuurd, worden geweigerd tot je de koppeling weer Inschakelen kiest.
- Integratie verwijderen trekt de API-sleutel en het webhook-endpoint in. Dit kan niet ongedaan worden gemaakt.
- Nog een org koppelen voegt een tweede org toe, bijvoorbeeld een sandbox.
Staat er op de Salesforce-kaart Niet in je abonnement, of dat de app niet meer beschikbaar is voor nieuwe koppelingen? Dan blijven je bestaande koppelingen werken; alleen nieuwe kun je niet meer toevoegen.
PostBuddy kan een koppeling uitschakelen, een API-sleutel intrekken of een webhook-endpoint uitzetten als er iets misgaat, bijvoorbeeld bij herhaalde fouten of een sleutel die openbaar is geworden. De Owners van je organisatie krijgen dan een melding met de reden.
De installatiehandleiding voor je Salesforce-beheerder beschrijft elke stap in detail: handleiding voor de Salesforce-koppeling.
Vertel ons wat je hebt geprobeerd en, als dat kan, om welk poststuk of welke Postbatch het gaat.