Skip to content

Salesforce ​

Salesforce chamando o produto ​

  1. Setup → Named Credentials → External Credentials → New: protocolo Custom; crie um Principal com o parâmetro de autenticação ApiKey = sua chave pk_live_....
  2. Em Custom Headers da External Credential: Authorization = Bearer {!$Credential.FluxiaApi.ApiKey}.
  3. Named Credential FluxiaApi com URL https://app.fluxia.protoncode.com.br/api/v1 usando a External Credential.
  4. Dê acesso ao Principal pelo Permission Set dos usuários/integração.
apex
HttpRequest req = new HttpRequest();
req.setEndpoint('callout:FluxiaApi/spaces');
req.setMethod('POST');
req.setHeader('Content-Type', 'application/json');
req.setHeader('Idempotency-Key', 'acc-' + acc.Id);
// Um espaço por cliente (Account); a chave vira o prefixo dos cartões.
req.setBody(JSON.serialize(new Map<String, Object>{ 'key' => 'ACME', 'name' => acc.Name }));
HttpResponse res = new Http().send(req);

Em Flow: ação HTTP Callout apontando para a Named Credential FluxiaApi.

Fluxia avisando o Salesforce ​

Crie um endpoint Apex REST e cadastre a URL do site público (ou Experience Cloud) como webhook. Valide a assinatura com o exemplo Apex de Webhooks antes de processar.

apex
@RestResource(urlMapping='/fluxia/webhook')
global without sharing class FluxiaWebhook {
    @HttpPost
    global static void receive() {
        RestRequest req = RestContext.request;
        String body = req.requestBody.toString();
        String sig = req.headers.get('X-Proton-Signature');
        if (!WebhookVerifier.verify(FluxiaSettings__c.getOrgDefaults().Secret__c, sig, body)) {
            RestContext.response.statusCode = 401;
            return;
        }
        // Enfileire o processamento (Queueable) e responda rápido.
        System.enqueueJob(new ProcessarEventoFluxia(body, req.headers.get('traceparent')));
        RestContext.response.statusCode = 202;
    }
}