> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Utilizar a integração do Salesforce em Pedidos HTTP do fluxo de chamadas

> Contacte o Salesforce a partir do seu fluxo de chamadas sem introduzir credenciais, utilizando a sua integração do Salesforce ligada.

<Note>
  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.
</Note>

**Nível de utilizador:** Admin

***

<h2 id="h_sf_before_you_start">
  Antes de começar
</h2>

* A sua integração do Salesforce tem de estar ligada e ativa na CloudTalk (**Dashboard** > **Integrações**). Consulte [Configurar o Salesforce](/pt/articles/3368501-configure-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.

<h2 id="h_sf_set_up">
  Configurar o pedido
</h2>

1. Adicione um passo **Pedido HTTP** ao seu fluxo de chamadas (consulte o guia [Passo Pedido HTTP](/pt/articles/6883940-http-request-step)).

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.

<h2 id="h_sf_example">
  Exemplo: registar uma chamada recebida como uma Task do Salesforce
</h2>

<table>
  <tbody>
    <tr>
      <td>
        **Campo**
      </td>

      <td>
        **Valor**
      </td>
    </tr>

    <tr>
      <td>
        **Ponto Final**
      </td>

      <td>
        `https://yourcompany.my.salesforce.com/services/data/v58.0/sobjects/Task`
      </td>
    </tr>

    <tr>
      <td>
        **Método**
      </td>

      <td>
        POST
      </td>
    </tr>

    <tr>
      <td>
        **Cabeçalhos**
      </td>

      <td>
        `Content-Type` = `application/json`
      </td>
    </tr>

    <tr>
      <td>
        **Corpo**
      </td>

      <td>
        `Assunto` = `Inbound call from #{{call.external_number}}`

        `Estado` = `Concluído`

        `Prioridade` = `Normal`
      </td>
    </tr>

    <tr>
      <td>
        **Analisar resposta**
      </td>

      <td>
        Desativado (enviar e esquecer)
      </td>
    </tr>
  </tbody>
</table>

<h2 id="h_sf_condition_splitter">
  Utilizar a resposta do Salesforce num Divisor de Condições
</h2>

Com a opção **Analisar resposta** ativada, a resposta do Salesforce é guardada como um único bloco. Num [Divisor de Condições](/pt/articles/5763009-caller-based-routing-with-conditions) 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**.

<Tip>
  **Nota:** De momento, não é suportada a leitura de um campo específico do Salesforce a partir da resposta (por exemplo, `records.0.Id`).
</Tip>

<h2 id="h_sf_not_available">
  Se a integração não estiver disponível
</h2>

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.

<h2 id="h_sf_good_to_know">
  Bom saber
</h2>

* 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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). Estamos aqui para si.


## Related topics

- [Ações do Salesforce](/pt/articles/9394264-salesforce-actions.md)
- [Passo Pedido HTTP](/pt/articles/6883940-http-request-step.md)
- [Acionar uma chamada do VoiceAgent a partir do Make](/pt/articles/11830974-triggering-a-voiceagent-call-from-make.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.