Tema
Salesforce
Salesforce chamando o produto
- Setup → Named Credentials → External Credentials → New: protocolo Custom; crie um Principal com o parâmetro de autenticação
ApiKey= sua chavepk_live_.... - Em Custom Headers da External Credential:
Authorization=Bearer {!$Credential.FluxiaApi.ApiKey}. - Named Credential
FluxiaApicom URLhttps://app.fluxia.protoncode.com.br/api/v1usando a External Credential. - 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;
}
}