Hyper Sistemas
Roadmap Acessar CRM

Como enviar uma mensagem de teste

⏱ 2 mincom exemplo prontovalida a integração

Este guia valida sua integração de ponta a ponta: você envia uma mensagem para um ticket (conversa) do seu CRM usando a API externa. Para acompanhar, use o guia de geração do token antes de começar.

  1. Pegue seu apiId e token

    Você precisa dos dois valores gerados no CRM (veja o guia Gerar o token de acesso).

  2. Pegue o número de um ticket aberto

    No CRM, abra uma conversa que está na fila e anote o número do ticket (ex.: 1234). É esse número que vai no campo ticketId.

  3. Copie o comando e substitua os placeholders

    Substitua {apiId}, {token} e 1234 pelos seus valores:

    curl.sh
    curl -X POST 'https://backend.hypersistema.com.br/v2/api/external/{apiId}/sendMessageByTicket'
  -H 'Authorization: Bearer {token}'
  -H 'Content-Type: application/json'
  -d '{
    "ticketId": 1234,
    "body": "Mensagem enviada pela API de teste"
  }'

  4. Execute

    Cole no terminal (ou no app que você está integrando). A resposta esperada é 200.

  5. Confira no CRM

    A mensagem "Mensagem enviada pela API de teste" deve aparecer dentro da conversa do ticket. Se apareceu, sua integração está validada.

Não tem curl no Windows? Use o PowerShell ou o Postman/Bruno — a chamada é a mesma: POST para a URL acima, cabeçalho Authorization: Bearer {token} e o corpo JSON.
Erro 401? Token ausente, inválido ou sem permissão — confira se copiou o token inteiro e se ele pertence ao mesmo tenant do {apiId}. Erro 409? O ticket pode estar fechado; envie com "reopen": true.

Não conseguiu?

Fale com a gente — resolvemos juntos em minutos.

Falar no WhatsApp

Próximos passos