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

# Habilitar Acesso à API do Zoho CRM

> Aprenda como habilitar o acesso à API do Zoho CRM para perfis de usuário para permitir a integração com o Eazybe e uma comunicação de dados fluida.

Este guia fornece aos administradores instruções para habilitar o acesso à API no nível de perfil no Zoho CRM. Habilitar o acesso à API é essencial para que o Eazybe se comunique com os dados do seu Zoho CRM.

## Quem Deve Usar Este Guia

<CardGroup cols={3}>
  <Card title="Administradores de CRM" icon="user-shield">
    Administradores do Zoho CRM que gerenciam permissões de usuário
  </Card>

  <Card title="Equipes de TI/Integração" icon="network-wired">
    Equipes configurando integrações de sistemas
  </Card>

  <Card title="Desenvolvedores" icon="code">
    Desenvolvedores configurando integrações baseadas em API
  </Card>
</CardGroup>

<Note>
  Apenas usuários com acesso administrativo podem modificar as configurações de segurança no nível de perfil no Zoho CRM.
</Note>

## Pré-requisitos

Antes de continuar, certifique-se de ter:

* **Acesso administrativo** ao Zoho CRM
* Conhecimento de qual **perfil** está atribuído ao usuário que faz chamadas à API (Padrão, Vendas ou perfis personalizados)

## Passos para Habilitar o Acesso à API

<Steps>
  <Step title="Fazer Login no Zoho CRM">
    Entre na sua conta do Zoho CRM com credenciais de administrador.

    <img src="https://mintcdn.com/eazybe/ZN7vbBac859XHlrA/images/1968881807.png?fit=max&auto=format&n=ZN7vbBac859XHlrA&q=85&s=be08d34f6cab466a170c19b3fd423b5c" alt="Fazer Login no Zoho CRM" width="1918" height="985" data-path="images/1968881807.png" />
  </Step>

  <Step title="Acessar Configuração">
    Clique no **ícone de engrenagem** (Configuração) no canto superior direito da tela.

    <img src="https://mintcdn.com/eazybe/ZN7vbBac859XHlrA/images/1968884377.png?fit=max&auto=format&n=ZN7vbBac859XHlrA&q=85&s=f5306ea6241ab8e79111a0911dc10890" alt="Acessar Configuração" width="1916" height="698" data-path="images/1968884377.png" />
  </Step>

  <Step title="Navegar para Controle de Segurança">
    Vá para **Security Control** e selecione **Profiles** das opções disponíveis.

    <img src="https://mintcdn.com/eazybe/ZN7vbBac859XHlrA/images/1968890074.png?fit=max&auto=format&n=ZN7vbBac859XHlrA&q=85&s=557b635b983fdedf74c1036acf6b167b" alt="Navegar para Controle de Segurança" width="1915" height="906" data-path="images/1968890074.png" />
  </Step>

  <Step title="Selecionar o Perfil do Usuário">
    Na aba **Profiles**, localize e clique no perfil atribuído ao usuário da API.

    <img src="https://mintcdn.com/eazybe/ZN7vbBac859XHlrA/images/1968891619.png?fit=max&auto=format&n=ZN7vbBac859XHlrA&q=85&s=db202daafc8e10a6c501281ec43b611e" alt="Selecionar Perfil do Usuário" width="1915" height="866" data-path="images/1968891619.png" />
  </Step>

  <Step title="Encontrar Permissões de Desenvolvedor">
    Role até a parte inferior da página de configurações do perfil e encontre a seção **Developer Permissions**.
  </Step>

  <Step title="Habilitar Acesso à API">
    Ative o interruptor **Zoho CRM API Access** para **ON**. O interruptor fica verde quando habilitado.

    <img src="https://mintcdn.com/eazybe/ZN7vbBac859XHlrA/images/1968892209.png?fit=max&auto=format&n=ZN7vbBac859XHlrA&q=85&s=cbeb8dc94fb43b81e18594ddaeea8bcb" alt="Habilitar Acesso à API" width="1915" height="866" data-path="images/1968892209.png" />
  </Step>

  <Step title="Salvar Alterações">
    Clique em **Save** para aplicar as permissões atualizadas.
  </Step>
</Steps>

## Verificação

Após habilitar o acesso à API, verifique a configuração:

<AccordionGroup>
  <Accordion title="Verificar Status do Perfil">
    O perfil deve exibir o status de **API Access** como **ON**.
  </Accordion>

  <Accordion title="Testar Autenticação">
    A autenticação do usuário deve ter sucesso com credenciais de API ou tokens OAuth.
  </Accordion>

  <Accordion title="Verificar Chamadas à API">
    As chamadas à API não devem mais retornar erros de permissão.
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<Warning>
  Se as chamadas à API ainda falharem após habilitar o acesso, verifique os seguintes problemas comuns:
</Warning>

| Problema                    | Solução                                                                             |
| --------------------------- | ----------------------------------------------------------------------------------- |
| Perfil incorreto atualizado | Verifique se você editou o perfil correto atribuído ao usuário da API               |
| Sessão não atualizada       | Peça ao usuário para fazer logout e login novamente                                 |
| Restrições de IP            | Verifique se restrições de acesso baseadas em IP estão bloqueando as chamadas à API |
| Escopo do OAuth             | Verifique se o token OAuth tem os escopos necessários                               |

## Melhores Práticas de Segurança

<Tip>
  Siga estas recomendações de segurança ao gerenciar o acesso à API:
</Tip>

* **Habilitar seletivamente** - Apenas habilite o acesso à API para perfis que necessitam
* **Evitar acesso amplo** - Não habilite o acesso à API para todos os perfis desnecessariamente
* **Auditorias regulares** - Revise periodicamente quais perfis têm o acesso à API habilitado
* **Revogar quando não usado** - Desabilite o acesso à API quando as integrações não estiverem mais em uso