Se seus sistemas que chamam a REST API do Intercom operam a partir de endereços IP fixos e conhecidos, a lista de permissões de IP da REST API permite que você garanta que apenas esses endereços possam autenticar — mesmo que uma chave API seja comprometida.
Isso adiciona uma camada de proteção em nível de rede além da autenticação baseada em token, reduzindo o risco de acesso não autorizado de locais inesperados.
Como funciona
O Intercom primeiro valida o token de acesso da requisição.
Se a lista de permissões de IP da REST API estiver ativada e sua lista contiver entradas, o Intercom verifica o IP de origem da requisição.
Se o IP não estiver permitido, a requisição retorna uma resposta
403 Forbiddencom a mensagem "Seu endereço IP não está na lista de permissões para acesso à API"
Configure
Ative “Habilitar lista de permissões de IP da REST API.”
Digite endereços IPv4 ou intervalos CIDR (separados por vírgula), por exemplo:
203.0.113.42
203.0.113.0/24
Clique em Salvar no topo da página
Resumo do comportamento
Recurso desativado → todos os IPs permitidos
Recurso ativado + lista vazia → todos os IPs permitidos
Recurso ativado + entradas → apenas IPs/intervalos listados permitidos
IP não listado → 403 Forbidden
Nota
Apenas IPv4; IPv6 ainda não é suportado.
Aplica-se a todos os métodos de autenticação da REST API (tokens OAuth ou chaves API).
Este controle é separado das “Restrições de acesso ao espaço de trabalho,” que governam quem pode entrar no painel do Intercom; ambos podem ser usados juntos.
Monitoramento
Um registro de atividade do colega será emitido quando alterações forem feitas na lista de permissões, permitindo que você monitore as mudanças.
Nota: Para monitorar a atividade bem-sucedida da REST API, você pode consumir o tópico webhook api.request.completed, que está atualmente em beta. Se estiver interessado neste recurso, entre em contato com o suporte e solicite-o.