# Consultar contato

{% tabs %}
{% tab title="Parâmetros" %}

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXd8QhsjMUOe4ZpOLeEZYrUv0uys1CEvjELeGEqFjak4lg2NCM3gZrl82W9ciMFEP114ts9NNQSinm0pDnIHFv9iCODgvEmiCWhIGqDrcGO5Th51y_MkDq1LyMvWI8P_rYGkApaL?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Parâmetros de configuração</p></figcaption></figure>

| Campo                  | Tipo           | Descrição                                                                                                                                                                                                                                                   |
| ---------------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Descrição              | Campo de texto | Descrição visual do conector no editor de fluxo                                                                                                                                                                                                             |
| Conta de serviço       | Seletor        | Permite selecionar a conta de serviço para conexão com ERP Bling. A conta de serviço deverá ser do tipo de autenticação OAuth2 e tipo de serviço Bling                                                                                                      |
| ID da conta de serviço | Campo de texto | <p>Configuração disponível quando selecionada a opção de conta de serviço personalizada.  </p><p></p><p>Permite inserir o identificador da conta de serviço Bling. Pode ser usado para aplicar valores dinâmicos utilizando a notação Mustache {{msg}} </p> |
| ID do contato          | Campo de texto | Identificador do contato cadastrado no ERP Bling.                                                                                                                                                                                                           |
| Output Path            | Campo de texto | Refere-se ao caminho do resultado da execução na saída do conector no contexto de execução do fluxo                                                                                                                                                         |
| {% endtab %}           |                |                                                                                                                                                                                                                                                             |

{% tab title="Payload" %}

## Sucesso

A requisição deste conector é feita para a API V3 na rota **GET** `/contatos/{idContato}`, permitindo obter as informações de um contato cadastrado na plataforma Bling. A documentação oficial pode ser consultada através do link [Bling Developer](https://developer.bling.com.br/referencia#/Contatos/get_contatos__idContato_)&#x20;

Quando a execução é bem-sucedida, os dados do contato ficam disponíveis na carga de dados do conector. Além disso, a resposta inclui informações adicionais da consulta nas chaves `request` e `response`.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc_xUZb6SBbvB73x3kz-0H9YWH3louPl_gXnP4WOe_3bLG9Y4eLaZEP4glINvPb9CL6Emu39MpXTPqnfr9RNOC-OZbfmgOYNN_CHdv2m3EyxQ9cFLMJU2Di3swKu9v_o31AJSRLfw?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Sucesso na consulta de contato</p></figcaption></figure>

## Erro

Em cenários de erro será retornado os dados da requisição, a response e a mensagem de erro mapeada na API. Segue exemplo de erro de quando contato não é encontrado.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdilYFq4JbUKPBRpPVsZG3bkRoWK5wdyB6HRVH2Xu8HmDGwlfzHbWDqFGTWKepzkkul76FQ0Zet8Q297oObOYqlIewwZcYwJF5omws__fvMPVDp5CCbxVQmNHa30uvQgYRKsfhm?key=yLogrgEbXy0K_a4zmB9ApgKO" alt=""><figcaption><p>Erro na consulta de contato</p></figcaption></figure>
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.floui.io/guia/conectores/categorias/servicos-externos/bling-erp-bling-api-v3/contatos/consultar-contato.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.