Sobre esta documentação. A referência é gerada a partir do contrato publicado pela API em produção, então mostra sempre as rotas que estão no ar. Os guias explicam o que o contrato não diz: credenciais, limites, erros e eventos. A Trina responde com trechos desta documentação e indica de onde tirou cada resposta.
A API pública do Trendmulti conecta seus sistemas à plataforma. Com ela você consulta e cadastra contatos, acompanha atendimentos, envia mensagens pelos canais e mantém o CRM em dia, sem passar pela tela.
Endereçohttps://apis.trendmulti.com.brLeitura de 4 min
O que dá para fazer
Contatos e etiquetas
Listar, consultar, cadastrar e atualizar contatos; listar e cadastrar etiquetas.
Atendimentos
Listar os atendimentos do canal, também por situação, e consultar um atendimento.
Mensagens
Enviar texto, mídia, botões e templates do WhatsApp oficial; listar as mensagens de um atendimento, contato ou telefone; consultar o status de uma mensagem enviada.
Equipe
Listar usuários e departamentos.
CRM
Funis, etapas, oportunidades, clientes, produtos e motivos de perda: listar, cadastrar, atualizar e mover oportunidades entre etapas.
Eventos
Receber no seu sistema os eventos de atendimento e de disparo, pelos webhooks de saída.
Endereço e formato
Endereço
Todas as chamadas vão para https://apis.trendmulti.com.br, por HTTPS.
Corpo
JSON nas duas direções. Envie o cabeçalho Content-Type: application/json nas chamadas com corpo.
Autorização
Um token de acesso no cabeçalho Authorization: Bearer, em todas as rotas menos a que gera o token (Autenticação).
Datas
ISO-8601 em UTC, como 2026-11-20T13:45:00.000Z.
Identificadores
24 caracteres hexadecimais, como 6563f0c2a1b2c3d4e5f60718.
Mensagens de erro
Sempre em português, com uma chave estável para o seu código (Erros).
A API trabalha por canal
As credenciais pertencem a um canal: um número de WhatsApp, uma conta do Instagram, um canal RCS. O token gerado com elas carrega a empresa e o canal, e cada rota usa um dos dois.
Rotas
Alcance
Listas de atendimentos e de departamentos
O canal do token.
Lista de mensagens
O canal do token; com idAttendance, o atendimento informado.
Envio de mensagens
A mensagem sai pelo canal do token.
Contatos, etiquetas, usuários e CRM
Toda a empresa.
Consultas por identificador
Toda a empresa.
Antes de começar
Módulo de API no plano. Sem ele, a aba API não aparece no canal.
Um canal conectado. A autenticação de um canal desconectado é recusada.
Acesso de administrador no Trendmulti, para pegar as credenciais na aba API do canal.
Este roteiro leva poucos minutos. Você pega as credenciais do canal, gera um token de acesso, confere que ele funciona e envia uma mensagem para um contato.
RotasPOST /api/auth›GET /api/info›POST /message/sendMessageLeitura de 5 min
1 · Pegue as credenciais do canal
No Trendmulti, abra Canais›abra o canal›API.
Se o canal ainda não tem credenciais, clique em Gerar novas credenciais.
Copie o UUID e o Token pelos botões de copiar.
2 · Gere o token de acesso
Envie o UUID e o Token para POST /api/auth. A resposta traz o token de acesso no campo token, válido por 24 horas.
Guarde o token e envie-o em todas as chamadas seguintes, no cabeçalho Authorization: Bearer <token>. Não autentique a cada chamada: o mesmo token vale por 24 horas.
3 · Confira o canal
GET /api/info devolve a empresa e o canal do token. É a forma mais simples de testar o cabeçalho de autorização.
Se a resposta for 401 com o texto Unauthorized, o token está ausente, malformado ou vencido (Usar o token).
4 · Envie uma mensagem
O envio precisa do identificador do contato. Busque um contato existente com GET /contact/pager ou cadastre um com POST /contact/create. O id da resposta é o idContact do envio.
Próximos passos
Receba eventos no seu sistema em vez de consultar a API o tempo todo.
A API usa um token de acesso (JWT) gerado a partir das credenciais do canal. O token vale por 24 horas e vai no cabeçalho de todas as chamadas.
RotaPOST /api/authLeitura de 4 min
Credenciais do canal
Cada canal tem um par de credenciais, UUID e Token, na aba API do canal (manual do usuário). Um par serve a um canal só.
Gerar novas credenciais substitui o par atual na hora: a autenticação com o par antigo passa a ser recusada. Tokens de acesso emitidos antes continuam válidos até vencer.
Gerar o token
Envie uuid e token para POST /api/auth. Esta é a única rota que não pede o cabeçalho de autorização.
successboolean
Sempre true numa resposta de sucesso.
channelobjeto
A empresa (company) e o canal (channel) do token, e expiresIn: a validade em segundos (86400, 24 horas). São os mesmos dados que GET /api/info devolve.
tokenstring
O token de acesso, para o cabeçalho Authorization.
Não existe rota de renovação. Gere um token novo antes que o atual vença, ou quando receber 401.
Sem o cabeçalho, ou com um token malformado ou vencido, a resposta é 401 com o texto Unauthorized no corpo, sem JSON. Gere um token novo e repita a chamada uma vez.
Erros de autenticação
Situação
Resposta
UUID ou Token errados, ou fora do formato (texto de 1 a 256 caracteres)
As rotas de lista devolvem um array simples, sem total de registros. Algumas paginam e outras devolvem tudo de uma vez.
Parâmetrospage·perPageLeitura de 4 min
Três tipos de lista
Rotas
Parâmetros
Observação
GET /contact/pager, GET /attendance/pager, GET /attendance/pager/status
page, a partir de 1, e perPage. Os dois são obrigatórios.
A API não limita perPage nessas rotas. Recomendamos até 100 por página.
GET /message/pager
page (padrão 1) e perPage (padrão 20, máximo 100).
Acima de 100, a chamada é recusada. Cada consulta tem até 5 segundos; passou disso, a resposta é 504.
Rotas /list: etiquetas, usuários, departamentos e CRM
Nenhum.
Devolvem todos os registros de uma vez.
Saber quando acabou
A resposta não traz o total. A última página é a que volta com menos itens que perPage, ou vazia. Avance page até isso acontecer.
JavaScript
async function listarContatos(token) {
const perPage = 100;
const todos = [];
for (let page = 1; ; page++) {
const res = await fetch(`https://apis.trendmulti.com.br/contact/pager?page=${page}&perPage=${perPage}`, {
headers: { Authorization: `Bearer ${token}` },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const pagina = await res.json();
todos.push(...pagina);
if (pagina.length < perPage) break; // última página
}
return todos;
}
Ordem e alcance
Rota
Ordem
Alcance
GET /contact/pager
Cadastrados mais recentemente primeiro.
Toda a empresa.
GET /attendance/pager e /attendance/pager/status
Atualizados mais recentemente primeiro.
O canal do token.
GET /message/pager
Mais novas primeiro.
O canal do token, ou o atendimento de idAttendance.
Na lista de mensagens, informe ao menos um filtro: idAttendance, idContact ou phone (referência).
Busca de contatos
O parâmetro search de GET /contact/pager divide o texto em palavras e ignora as que têm menos de 3 letras. Cada palavra precisa aparecer no começo do nome, do e-mail, da cidade, do endereço, da empresa ou do cargo do contato, ou em qualquer parte do telefone.
Quando uma chamada falha, a API responde com um código HTTP e, na maioria dos casos, um JSON com a mensagem e a chave do erro.
Idioma das mensagenspt-BRLeitura de 5 min
Formato da resposta
JSON
{
"statusCode": 400,
"timestamp": "2026-11-20T13:45:00.000Z",
"path": "/message/pager?idAttendance=6563f0c2a1b2c3d4e5f60718&perPage=500",
"message": "O parâmetro perPage deve ser um número inteiro entre 1 e 100.",
"key": "errors.apis.invalidPerPage"
}
statusCode
O mesmo código HTTP da resposta.
timestamp
Quando o erro aconteceu, em UTC.
path
A rota chamada, com os parâmetros.
message
O texto do erro, em português.
key
A chave estável do erro, quando ele tem uma. Use a chave no seu código, não o texto.
Códigos HTTP
Código
Quando acontece
200
Sucesso. Uma consulta por identificador que não encontra o registro, ou que aponta para outra empresa, também responde 200, com o corpo vazio.
201
Registro criado: rotas create e envio de mensagens.
400
Dados inválidos ou regra de negócio recusada.
401
Credenciais inválidas, ou token ausente, malformado ou vencido.
403
Empresa bloqueada.
404
Registro não encontrado numa atualização, ou contato de outra empresa num envio de mensagem.
409
Conflito. No CRM, o contato já pertence a outro cliente ou o CPF/CNPJ já está em uso. No RCS, o envio foi recusado porque o canal é só de campanha ou a sessão expirou.
500
Erro inesperado. Tente de novo; se persistir, fale com o suporte.
504
A consulta passou do tempo, na lista de mensagens. Refine os filtros.
Chaves de erro
Chave
Mensagem
errors.apis.invalidCredentials
Credenciais inválidas.
errors.apis.invalidId
O parâmetro informado deve ser um identificador válido (24 caracteres hexadecimais).
errors.apis.invalidPage
O parâmetro page deve ser um número inteiro maior ou igual a 1.
errors.apis.invalidPerPage
O parâmetro perPage deve ser um número inteiro entre 1 e 100.
errors.apis.invalidPhone
O parâmetro phone deve ser um telefone em formato internacional, com DDI e DDD (ex.: 5511999998888).
errors.apis.invalidStatus
O parâmetro status aceita os valores permitidos, separados por vírgula.
errors.apis.messageFilterRequired
Informe ao menos um filtro: idAttendance, idContact ou phone.
errors.apis.queryTimeout
A consulta demorou mais que o permitido. Refine os filtros e tente novamente.
errors.apis.recordNotFound
Registro não encontrado.
errors.contact.notFound
Contato não encontrado.
errors.customer.notFound
Cliente não encontrado
Como tratar
4xx: corrija a chamada. Repetir igual não resolve.
401: gere um token novo e repita a chamada uma vez.
500 e 504: repita com espera crescente, como 1, 2 e 4 segundos. No 504 da lista de mensagens, reduza perPage ou filtre por idAttendance.
200 com corpo vazio numa consulta por identificador: trate como registro não encontrado.
O que a API aceita em cada campo, quanto tempo uma consulta pode levar e onde ver o registro de cada chamada que o seu sistema fez.
No TrendmultiRelatórios›Relatório de APILeitura de 3 min
Volume de chamadas
Hoje a API não limita o número de chamadas por minuto. Mesmo assim, reaproveite o token, evite consultas repetidas em intervalos curtos e prefira os webhooks de saída para saber quando algo muda.
Empresas em período de teste têm um limite total de chamadas definido no plano. Quando ele é atingido, a autenticação passa a ser recusada.
A lista de mensagens tem até 5 segundos por consulta. Passou disso, a resposta é 504.
Formatos
Identificadores
24 caracteres hexadecimais, como 6563f0c2a1b2c3d4e5f60718. Um valor fora do formato numa consulta responde como registro não encontrado; numa atualização, responde 404.
Telefones
Só dígitos, com DDI e DDD: 5511999998888. Na lista de mensagens por telefone, o nono dígito é opcional. No cadastro de contato, o telefone é gravado como foi enviado, e um telefone já cadastrado recusa o cadastro.
Datas
ISO-8601 em UTC, como 2026-11-20T13:45:00.000Z.
Textos
UTF-8.
Registro das chamadas
Cada chamada que chega à API fica registrada no Trendmulti, com URL, data, método, canal e status, e os corpos da requisição e da resposta. Para consultar, abra Relatórios›Relatório de API (manual do usuário). É o primeiro lugar para olhar quando uma integração reclama de erro.
O cabeçalho de autorização e o token de acesso não aparecem no registro.
Os webhooks de saída avisam o seu sistema quando algo acontece no canal: um atendimento abre, chega uma mensagem, uma mensagem de disparo é entregue. Em vez de consultar a API o tempo todo, você recebe o aviso na hora.
No TrendmultiCanais›abra o canal›WebhooksLeitura de 8 min
Configurar
No Trendmulti, abra Canais›abra o canal›Webhooks.
Clique em + Adicionar.
Informe um Nome que identifique o destino e a URL do seu sistema.
Escolha os eventos, deixe o webhook ativado e clique em Confirmar.
Um canal pode ter vários webhooks, cada um com a sua URL e os seus eventos. O passo a passo da tela está no manual do usuário.
Eventos
Na tela
Valor de event
Quando
Ao criar novo atendimento
ATTENDANCE_CREATE
Um atendimento é aberto.
Ao receber lead do Meta
ATTENDANCE_REFERRAL_CREATE
Um atendimento começa a partir de um anúncio do Meta.
Ao encerrar atendimento
ATTENDANCE_CLOSE
O atendimento é encerrado.
Ao receber nova mensagem
ATTENDANCE_NEW_MESSAGE
Chega uma nova mensagem no atendimento.
Ao transferir atendimento
ATTENDANCE_TRANSFER
O atendimento muda de atendente ou de departamento.
Ao enviar nova mensagem de disparo
CAMPAIGN_MESSAGE_SENT
O provedor aceitou a mensagem para envio.
Ao receber confirmação de entrega de mensagem de disparo
CAMPAIGN_MESSAGE_DELIVERED
O provedor confirmou a entrega.
Ao receber confirmação de leitura de mensagem de disparo
CAMPAIGN_MESSAGE_READ
O provedor confirmou a leitura.
Ao receber falha de envio de mensagem de disparo
CAMPAIGN_MESSAGE_FAILED
A mensagem foi recusada no envio, ou foi aceita e não pôde ser entregue.
Ao concluir disparo de campanha
CAMPAIGN_CONCLUDED
O disparo terminou: concluído, cancelado ou com erro.
Os eventos de disparo existem nos canais de WhatsApp, oficial e não oficial, e de RCS.
Como o aviso chega
Método
POST, com corpo JSON e o cabeçalho Content-Type: application/json.
Resposta esperada
Qualquer código 2xx, rápido. Nos eventos de disparo, o Trendmulti espera até 10 segundos.
Novas tentativas
Se a entrega falha, o aviso é enviado de novo, até 3 vezes.
Ordem
Os avisos podem chegar fora de ordem. Use a data de cada um: occurredAt nos disparos e updatedAt nos atendimentos.
Volume
Até 150 avisos de disparo ao mesmo tempo para o mesmo endereço. Um disparo grande gera até três avisos por contato: envio, entrega e leitura.
Formato: eventos de atendimento
Os cinco eventos de atendimento têm o mesmo formato. Campos sem valor não vêm no aviso.
DONE, CANCELED ou ERROR. Com ERROR, reason traz o motivo.
kpis
Os números da tela de detalhamento do disparo naquele momento. Entregues e lidas ainda podem crescer, porque as confirmações continuam chegando.
kpis.rates
Percentuais com duas casas, ou null quando ainda não há base para o cálculo.
cost
O custo do disparo, ou null. Com estimate: true, é uma estimativa pela tabela da Meta, na moeda dela; com false, é o valor cobrado da carteira, em reais.
Boas práticas
Responda 2xx assim que receber e processe depois, numa fila sua.
Trate avisos repetidos: com as novas tentativas, o mesmo aviso pode chegar mais de uma vez. Nos disparos, use event + message.id; nos atendimentos, event + protocol + updatedAt.
Aceite valores novos de event e de transfer.origin sem falhar.
O webhook de integração recebe dados do seu sistema, como o formulário do site, uma landing page ou o ERP, e executa as ações montadas na tela: cadastrar o contato, enviar uma mensagem, aplicar etiquetas, abrir atendimento ou criar uma oportunidade.
No TrendmultiIntegrações›WebhookLeitura de 4 min
Quando usar
Use o webhook de integração quando o Trendmulti deve reagir a um evento do seu sistema sem você programar cada passo. As ações ficam configuradas na tela, e o seu sistema só envia os dados.
Para controlar cada passo, como escolher o contato, o texto ou a etapa do funil na hora, use a API.
Configurar
No Trendmulti, abra Integrações›Webhook e clique em + Adicionar. A URL do Webhook aparece no topo.
Envie uma chamada de teste do seu sistema. Ela aparece no painel Requisições, e os campos dela viram opções nas ações.
Monte as ações e clique em Salvar.
Mude a chave ao lado da URL de Modo Teste para Funcionando.
O botão Gerar cURL copia um exemplo de chamada. O webhook de integração depende do módulo de webhook no plano. O passo a passo completo está no manual do usuário.
https://integrations.trendmulti.com.br/webhook/{código da empresa}/{identificador do webhook}/, exatamente como a tela mostra.
Método
Qualquer um. Use POST.
Corpo
JSON, application/x-www-form-urlencoded ou multipart/form-data com um arquivo no campo file. Os nomes dos campos são livres: você aponta na tela qual campo é o telefone, qual é o nome e assim por diante.
Autenticação
A própria URL. Quem a tiver consegue enviar dados: compartilhe só com quem vai integrar e não a publique em páginas abertas.
Respostas
Código
O que significa
200
A chamada foi registrada e as ações rodaram.
503
A chamada não pôde ser registrada e nada foi executado. Repita depois do tempo do cabeçalho Retry-After (30 segundos).
500
Erro ao executar as ações.
Toda chamada é registrada, mesmo quando nenhuma ação roda. Em período de teste, o número de chamadas recebidas é limitado.
O contrato da API em um arquivo, para importar nas suas ferramentas ou entregar a um assistente de código, e o atalho para consultar a conta em linguagem natural.
Arquivo/openapi.jsonLeitura de 3 min
Contrato OpenAPI (JSON e YAML)
Todas as rotas, parâmetros e modelos da API estão num contrato OpenAPI 3.0, que a própria API publica. É ele que gera a referência desta documentação. Use o endereço direto para levar a API ao Postman, ao Insomnia ou a uma IA:
openapi.json, para baixar e guardar junto do seu projeto.
No Postman
Clique em Import e cole o endereço do JSON.
Confirme a importação. As rotas aparecem numa coleção, agrupadas como na referência.
Gere o token com POST /api/auth e informe-o na autorização da coleção, como Bearer Token.
No Insomnia, o caminho é o mesmo: importe pelo endereço ou pelo arquivo. Quando a API ganhar uma rota nova, importe de novo pelo endereço para atualizar a coleção.
Numa IA
Entregue o endereço do JSON ou do YAML, ou o arquivo, ao assistente e peça a integração que você precisa, por exemplo: “Usando o contrato em https://apis.trendmulti.com.br/-json, escreva uma função que autentica e envia uma mensagem de texto para um contato”. O contrato traz rotas, campos e tipos; os guias desta documentação trazem as regras que ele não diz, como a validade do token e a paginação.
Swagger
O Swagger em apis.trendmulti.com.br mostra o mesmo contrato e deixa você testar as rotas. Gere o token com POST /api/auth e informe-o em Authorize.
Assistentes de código
Ao pedir a um assistente de código uma integração com o Trendmulti, entregue o contrato como contexto: o endereço https://apis.trendmulti.com.br/-json ou o arquivo. O arquivo llms.txt resume esta documentação para ferramentas de IA, com as regras que o contrato não diz, e aponta para o contrato.
Clientes de IA (MCP)
Para consultar a conta em linguagem natural, sem programar, o Trendmulti tem um conector para Claude, ChatGPT e outros clientes compatíveis com MCP, no endereço https://mcp.trendmulti.com.br/mcp.
Ele é diferente da API: cada pessoa entra com o próprio usuário do Trendmulti, vê só o que já vê na plataforma e não altera nada. O acesso é ativado por empresa; veja como no manual do usuário.
Status e suporte
A disponibilidade da plataforma aparece na página de status. Para dúvidas sobre a sua integração, fale com o suporte pelo link Suporte no rodapé do Trendmulti.
As mudanças da API e dos webhooks que afetam quem integra, das mais recentes para as mais antigas.
Novembro de 2026
Eventos de disparo nos webhooks de saída.CAMPAIGN_MESSAGE_SENT, CAMPAIGN_MESSAGE_DELIVERED, CAMPAIGN_MESSAGE_READ, CAMPAIGN_MESSAGE_FAILED e CAMPAIGN_CONCLUDED (formato).
Autenticação mais rígida. UUID e Token precisam ser texto de 1 a 256 caracteres; fora disso, ou errados, a resposta é 401 com errors.apis.invalidCredentials. Todas as rotas, inclusive as do CRM, verificam o token. Consultas e atualizações por identificador ficam restritas à empresa do token. O token de acesso deixou de carregar as credenciais do canal.
Nova documentação. A referência passou a ser gerada a partir do contrato publicado pela API em produção, com guias, exemplos em quatro linguagens e a Trina.
Outubro de 2026
Filtros na lista de mensagens.GET /message/pager passou a aceitar idContact, phone e status, além de idAttendance, com validação de page e perPage (máximo 100) e limite de 5 segundos por consulta.
Clientes do CRM com dados da empresa. O cadastro de clientes aceita razão social, nome fantasia, CPF ou CNPJ, inscrição estadual, site, Instagram, segmento, porte, endereço e o código do cliente no seu ERP (referência).
Setembro de 2026
Evento de transferência. O webhook de saída ganhou o evento ATTENDANCE_TRANSFER, com o bloco transfer (formato).
Esc
↑ ↓ navegarEnter abrir
T
TrinaAssistente da documentação da API
A Trina responde com trechos desta documentação e mostra de onde tirou cada resposta.