Skip to main content
O passo Pedido HTTP pode contactar diretamente a sua org do Salesforce. Quando o ponto final é o endereço da sua org do Salesforce, a CloudTalk assina o pedido com a sua integração do Salesforce ligada, pelo que nunca introduz credenciais do Salesforce no fluxo de chamadas.
Nível de utilizador: Admin

​
Antes de começar

  • A sua integração do Salesforce tem de estar ligada e ativa na CloudTalk (Dashboard > Integrações). Consulte Configurar o Salesforce.
  • O ponto final tem de utilizar o domínio da sua própria org, por exemplo https://yourcompany.my.salesforce.com/.... Outros endereços do Salesforce, como login.salesforce.com ou o Marketing Cloud, não são suportados.
  • Precisa de saber que chamada da REST API do Salesforce pretende fazer. A documentação da API do Salesforce lista os pontos finais disponíveis.

​
Configurar o pedido

  1. Adicione um passo Pedido HTTP ao seu fluxo de chamadas (consulte o guia Passo Pedido HTTP).
  2. Em Ponto Final, introduza o URL completo da API do Salesforce no domínio da sua org.
  3. Escolha o Método e preencha os Cabeçalhos de pedido e o Corpo do pedido conforme a API do Salesforce exigir. Para um corpo em JSON, adicione o cabeçalho Content-Type: application/json.
  4. Não adicione um cabeçalho Authorization. A CloudTalk acrescenta a autenticação por si, utilizando a integração ligada.
  5. Guarde o fluxo.
Sempre que uma chamada chega a este passo, a CloudTalk envia o pedido ao Salesforce em nome da sua integração. Pode utilizar variáveis dinâmicas como #{{call.external_number}} no ponto final, nos cabeçalhos e no corpo, tal como em qualquer passo Pedido HTTP.

​
Exemplo: registar uma chamada recebida como uma Task do Salesforce

CampoValor
Ponto Finalhttps://yourcompany.my.salesforce.com/services/data/v58.0/sobjects/Task
MétodoPOST
CabeçalhosContent-Type = application/json
CorpoAssunto = Inbound call from #{{call.external_number}}Estado = ConcluídoPrioridade = Normal
Analisar respostaDesativado (enviar e esquecer)

​
Utilizar a resposta do Salesforce num Divisor de Condições

Com a opção Analisar resposta ativada, a resposta do Salesforce é guardada como um único bloco. Num Divisor de Condições pode:
  • Verificar o código de estado: selecione Resposta HTTP, caminho statusCode, por exemplo igual a 200.
  • Verificar se a resposta contém um valor: selecione Resposta HTTP, caminho body, operando contém.
Nota: De momento, não é suportada a leitura de um campo específico do Salesforce a partir da resposta (por exemplo, records.0.Id).

​
Se a integração não estiver disponível

Se a sua integração do Salesforce estiver desativada ou não estiver ligada, ou se o ponto final não corresponder à org a que está ligada, o pedido não é enviado ao Salesforce. O passo é registado como falhado e o fluxo de chamadas prossegue para o passo seguinte. Os autores das chamadas não são afetados.

​
Bom saber

  • A comunicação exige HTTPS.
  • Quando a opção Analisar resposta está ativada, o fluxo aguarda até 10 segundos pela resposta do Salesforce. Quando está desativada, o pedido é enviado e o fluxo avança após 3 segundos, no máximo.
  • Os pedidos contam para os limites da API do Salesforce, tal como qualquer outra chamada à API.
Precisa de ajuda ou tem alguma questão? Basta contactar-nos através do nosso Portal de Suporte. Estamos aqui para si.