Oficina

Tema

Salesforce ​

Salesforce chamando a Oficina ​

  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.OficinaApi.ApiKey}.
  3. Named Credential OficinaApi com URL https://app.oficina.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:OficinaApi/service-orders?open=true');
req.setMethod('POST');
req.setHeader('Content-Type', 'application/json');
req.setHeader('Idempotency-Key', 'opp-' + opp.Id);
req.setBody(JSON.serialize(new Map<String, Object>{ 'name' => opp.Name }));
HttpResponse res = new Http().send(req);

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

Oficina 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='/oficina/webhook')
global without sharing class OficinaWebhook {
    @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(OficinaSettings__c.getOrgDefaults().Secret__c, sig, body)) {
            RestContext.response.statusCode = 401;
            return;
        }
        // Enfileire o processamento (Queueable) e responda rápido.
        System.enqueueJob(new ProcessarEventoOficina(body, req.headers.get('traceparent')));
        RestContext.response.statusCode = 202;
    }
}