# Integrações no SimplesDesk: API aberta e integrações nativas O SimplesDesk foi feito para conversar com o resto da sua operação. Há três caminhos para integrar — do mais flexível ao mais pronto — e este guia explica quando usar cada um e onde encontrar o passo a passo de cada integração. ## 1. API totalmente aberta: integre o que você quiser Antes de tudo: **nossa API é aberta e completa**. Praticamente tudo o que é feito pela interface pode ser feito por API — o que significa que, mesmo que o seu sistema não tenha integração nativa, **dá para integrar**. Alguns exemplos reais de uso dos endpoints: - **Contatos** — criar e atualizar contatos a partir do seu ERP/CRM (sincronize o cadastro: nome, telefone, e-mail, atributos personalizados como CPF ou código do cliente). - **Conversas e mensagens** — abrir uma conversa e enviar mensagem a partir de um evento do seu sistema (ex.: "pedido despachado" no ERP dispara aviso ao cliente no canal dele). - **Etiquetas, times e atribuição** — aplicar etiquetas e direcionar conversas com base em regras que vivem fora da plataforma (ex.: seu sistema antifraude marca a conversa como `analise`). - **Relatórios** — extrair conversas, tempos de resposta e volumes para o seu BI. - **Webhooks** — o caminho inverso: a plataforma **avisa o seu sistema em tempo real** (mensagem recebida, conversa criada, conversa resolvida) para você reagir do seu lado. Um exemplo de chamada — criar um contato: ``` POST /api/v1/accounts/{id_da_conta}/contacts Content-Type: application/json api_access_token: SEU_TOKEN { "name": "Maria Silva", "phone_number": "+5511999998888" } ``` A autenticação usa o **token de acesso do seu perfil** (Configurações do perfil → Token de acesso). A referência completa de endpoints está na **[Documentação oficial da API](https://chat.simplesdesk.com.br/api/swagger)** (também acessível em **Configurações → Avançado → Documentação da API**) — veja o artigo [Documentação da API](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/1771526490-documentacao-da-api) para o passo a passo de acesso. > 📘 **Integração sem programar**: dentro dos **Fluxos** você também integra APIs externas sem escrever código — o nó **Requisição HTTP** chama qualquer API durante o atendimento e usa a resposta na conversa, e o gatilho **Webhook** inicia fluxos a partir de eventos do seu sistema. Veja [Requisição HTTP: integre APIs ao seu fluxo](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/requisicao-http-integre-apis-ao-seu-fluxo). ## 2. Integrações nativas: conectores prontos Para os sistemas mais usados pelos nossos clientes, existem **integrações nativas**: você informa as credenciais e a plataforma cuida do resto. O padrão é sempre o mesmo: 1. Acesse **Configurações → Integrações** e clique no card do sistema. 2. Informe as credenciais (chaves de API do sistema em questão). 3. Clique em **Conectar** — a integração fica ativa para toda a conta. Uma vez conectada, a integração habilita recursos em três lugares: - **Agente de IA** — ganha ferramentas do sistema (ex.: consultar um boleto no Asaas, localizar um pedido na Nuvemshop) e responde o cliente com o dado real, na hora. - **Fluxos** — nós e ações específicos da integração aparecem no editor de fluxos para montar jornadas automatizadas (ex.: consultar agenda do Feegow e oferecer horários). - **Gatilhos** — eventos da integração podem iniciar fluxos e automações. ## 3. Catálogo de integrações nativas ### ERP e Financeiro - [Omie ERP](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-omie) — clientes, contas a receber, pedidos e produtos. - [Conta Azul](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-contaazul) — clientes, vendas e financeiro. - [Asaas](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-asaas) — cobranças, links de pagamento e 2ª via direto nas conversas. - [G-Click](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-gclick) — obrigações e tarefas do escritório contábil. - [Superlógica Assinaturas](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-superlogica) — assinaturas e cobranças recorrentes. - [Superlógica Condomínios](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-superlogica-condominios) — boletos e dados de condôminos. ### E-commerce - [Nuvemshop](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-nuvemshop) — pedidos, status de entrega e catálogo. - [Magazord](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-magazord) — pedidos e rastreio. - [Loja Integrada](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-lojaintegrada) — pedidos e clientes da loja. ### Saúde - [Feegow](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-feegow) — agenda médica e agendamento automatizado. - [Consultorio.me](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-consultoriome) — agenda e pacientes do consultório. ### Imobiliário e Construção - [CV CRM](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-cvcrm) — leads e empreendimentos do mercado imobiliário. - [Sienge](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-sienge) — dados financeiros e de obras da construtora. ### Provedores e Telefonia - [IXC Soft](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-ixc) — clientes, faturas e chamados do provedor. - [SONAX Pabx](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-sonax) — telefonia integrada ao atendimento. ### Marketing e CRM - [RD Station](https://chat.simplesdesk.com.br/hc/central-de-ajuda/articles/integracao-rdstation) — leads e oportunidades sincronizados com o marketing. ## Qual caminho escolher? 1. **Seu sistema está no catálogo acima?** Use a integração nativa — é conectar e usar. 2. **Não está, mas tem API?** Use o nó **Requisição HTTP** nos fluxos (sem código) ou a **nossa API aberta** (integração completa nos dois sentidos). 3. **Precisa reagir a eventos da plataforma?** Configure **webhooks** e receba tudo em tempo real no seu sistema. E se o seu sistema é muito usado no seu segmento e você acredita que merece integração nativa, fale com o nosso time — o catálogo cresce a partir do uso real dos clientes.