# Trendmulti — API pública > Trendmulti é uma plataforma B2B de atendimento omnichannel e CRM (WhatsApp, Instagram, Messenger, RCS e webchat). A API pública, em https://apis.trendmulti.com.br, permite consultar e cadastrar contatos, listar atendimentos, enviar mensagens (texto, mídia, botões e templates do WhatsApp oficial) e manter o CRM (funis, etapas, oportunidades, clientes, produtos e motivos de perda). Documentação em português. O contrato completo, com todas as rotas, parâmetros e modelos, está em OpenAPI 3.0: - [Contrato em JSON](https://apis.trendmulti.com.br/-json): publicado pela própria API em produção. Use-o como fonte das rotas e dos campos. - [Contrato em YAML](https://apis.trendmulti.com.br/-yaml): o mesmo contrato, em YAML. - [openapi.json](https://developer.trendmulti.com.br/openapi.json): cópia do contrato servida com esta documentação. Pontos que o contrato não diz: - Autenticação: `POST /api/auth` com `{"uuid": "...", "token": "..."}` (credenciais da aba API do canal no Trendmulti) devolve `{"success": true, "channel": {...}, "token": ""}`. O token vale 24 horas, sem renovação; envie `Authorization: Bearer ` em todas as outras rotas. Token ausente ou vencido: `401` com corpo de texto `Unauthorized`. - A API trabalha por canal: listas de atendimentos, departamentos e mensagens ficam no canal do token; contatos, usuários, etiquetas e CRM valem para a empresa toda. - Paginação: `page` começa em 1. As listas devolvem um array sem total; a última página é a que vem com menos itens que `perPage`. `GET /message/pager` aceita `perPage` até 100, exige `idAttendance`, `idContact` ou `phone` e responde `504` acima de 5 segundos. - Erros: JSON `{statusCode, timestamp, path, message, key}`, mensagens em português; use `key`. Consulta por identificador sem registro responde `200` com corpo vazio. - Formatos: identificadores com 24 caracteres hexadecimais; telefones só com dígitos, com DDI e DDD (`5511999998888`); datas ISO-8601 em UTC. - WhatsApp oficial: mensagem livre só é entregue até 24 horas depois da última mensagem do cliente; fora disso, use `POST /message/sendTemplateMessage`. - Webhooks de saída: `POST` JSON sem assinatura, até 3 novas tentativas, podem chegar fora de ordem. Eventos `ATTENDANCE_CREATE`, `ATTENDANCE_REFERRAL_CREATE`, `ATTENDANCE_CLOSE`, `ATTENDANCE_NEW_MESSAGE`, `ATTENDANCE_TRANSFER`, `CAMPAIGN_MESSAGE_SENT`, `CAMPAIGN_MESSAGE_DELIVERED`, `CAMPAIGN_MESSAGE_READ`, `CAMPAIGN_MESSAGE_FAILED` e `CAMPAIGN_CONCLUDED`; o campo `event` diz qual chegou. ## Documentação - [Guias e referência](https://developer.trendmulti.com.br/): primeira chamada, autenticação, paginação, erros, limites, webhooks de saída, webhook de integração e novidades. - [Manual do usuário](https://suporte.trendmulti.com.br/): como configurar canais, credenciais, webhooks e integrações na tela do Trendmulti.