API e Webhooks

O Pro adiciona duas maneiras de conectar o PrimoCRM ao restante da sua pilha: chaves de API para acesso programático e webhooks de saída para enviar eventos a outros sistemas.

Chaves de API

As chaves de API permitem que aplicativos e scripts externos leiam e gravem dados do PrimoCRM de forma programática.

1. Vá em Configurações, depois em API e crie uma chave.
2. Armazene a chave com segurança. Trate-a como uma senha.
3. Use-a para autenticar solicitações do seu aplicativo.

Uso típico:

• Sincronizar contatos de um sistema que não possui integração direta.
• Adicionar ou atualizar contatos a partir de um fluxo de cadastro personalizado.
• Extrair dados para um painel interno.

Cuidado

Uma chave de API pode ler e alterar os dados do seu CRM. Mantenha-a em segredo, nunca a envie para o controle de versão e revogue qualquer chave que suspeite estar exposta.

Webhooks de saída

A ação de automação Webhook de saída envia um HTTP POST para uma URL de sua escolha quando o fluxo chega a essa etapa. Use-a para notificar outros serviços em tempo real.

1. Adicione uma etapa de Webhook de saída a uma automação.
2. Defina a URL de destino.
3. Configure o payload. Você pode incluir dados de contato por meio de códigos inteligentes.

Um exemplo prático

1. Gatilho: Pedido do WooCommerce criado.
2. Webhook de saída: POST para o seu serviço de atendimento com o e-mail do contato e os detalhes do pedido.
3. Adicionar tag: customer.

No momento em que um pedido é feito, seu sistema externo é notificado e o contato recebe a tag, sem nenhuma etapa manual.

Notas de segurança

• Aponte webhooks apenas para endpoints que você controla ou confia. Um webhook pode transportar dados de contato para a URL de destino.
• Prefira destinos HTTPS para que o payload seja criptografado em trânsito.
• Valide as solicitações de webhook de entrada no lado receptor.

Onde eles se encontram no catálogo está listado em Gatilhos e Ações.