Skip to main content
A integração com o Make.com (anteriormente Integromat) permite que seus cenários no Make disparem ações na Timely.ai e que eventos da Timely.ai iniciem cenários no Make — tudo via webhooks bidirecionais.
Configuracao da integracao Make.com

​
Como a integração funciona

A Timely.ai expõe um endpoint dedicado (make-webhook) que recebe payloads do Make. Na direção oposta, você configura um Webhook URL do Make como destino de ações nos seus agentes ou workflows. 
Make → POST /functions/v1/make-webhook → Timely.ai
Timely.ai → POST webhook_url → Make (Webhook trigger do cenário)

​
Configurando a integração

1

Abra o agente

No painel da Timely.ai, acesse o agente que você quer conectar ao Make e vá até a aba Ferramentas / Integrações.
2

Ative a integracao Make

Clique em Configurar ao lado de Make.com. O diálogo de configuração será aberto.
3

Preencha as credenciais

Informe os campos abaixo:
CampoDescrição
Webhook URLURL do webhook de entrada do seu cenário Make
API KeyChave de API da sua conta Make (para autenticação opcional)
Team IDID do time no Make (para identificar a origem)
4

Salve e teste

Clique em Salvar configuração. Use o botão Testar conexão para enviar um payload de teste ao Make e confirmar que o cenário recebe corretamente.
5

Gerencie os cenarios

Na seção Cenários, você verá a lista de cenários vinculados. Ative ou desative individualmente cada um com o toggle.
O campo API Key é armazenado com criptografia em repouso. Ele nunca é retornado nas respostas da API — apenas indicado como configurado.

​
Recebendo dados do Make na Timely.ai

O endpoint make-webhook aceita payloads com a seguinte estrutura mínima: 
{
  "company_id": "uuid-da-sua-empresa",
  "agent_id": "uuid-do-agente",
  "action": "send_message",
  "data": {
    "contact_id": "uuid-do-contato",
    "message": "Olá, seu pedido foi aprovado!"
  }
}

​
Segurança

Todas as requisições devem incluir o token de autenticação no header: 
X-Make-Webhook-Token: <seu-token>
O token é configurado na variável de ambiente MAKE_WEBHOOK_SECRET. Requisições sem o token correto recebem 401 Unauthorized.
Nunca exponha seu token de webhook em repositórios públicos ou logs. Gere um novo token no painel se suspeitar de comprometimento.

​
Campos disponíveis no payload

CampoTipoObrigatórioDescrição
company_idstring (UUID)SimIdentificador da empresa
agent_idstring (UUID)NãoAgente que executará a ação
scenario_idstringNãoID do cenário Make para rastreamento
execution_idstringNãoID da execução Make para deduplicação
actionstringNãoAção a executar na Timely.ai
dataobjectNãoDados adicionais da ação
Use o campo execution_id enviado pelo Make para garantir idempotência — se o mesmo evento for entregue duas vezes (retry do Make), a Timely.ai pode ignorar a duplicata.