WavUps CRM
Entrar
Instagram

Disparar Mensagem

Envia mensagens através da API Oficial do Instagram (Meta Graph API) para um usuário destinatário.

POST/instagram/send-message
curl --request POST \
  --url 'https://crm.wavups.com/api/v1/instagram/send-message' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "accountIntegrationId": "cmint9876543210",
    "recipientId": "123456789012345",
    "type": "text",
    "text": {
      "body": "Olá! Como posso ajudar?"
    }
  }'
{
  "message": "Instagram message send task queued successfully."
}

Visão Geral

Este endpoint permite disparar mensagens no Instagram Direct através da Meta Graph API de forma assíncrona.

[!IMPORTANT] O parâmetro accountIntegrationId é obrigatório. Obtenha o ID correspondente à sua integração de Instagram através do endpoint Listar Integrações.

Requisição

POST https://crm.wavups.com/api/v1/instagram/send-message

Tokenstringobrigatório

Seu token de autenticação.

Body

accountIntegrationIdstringobrigatório

ID da integração de Instagram na sua conta (consulte Listar Integrações).

recipientIdstringobrigatório

ID do usuário no Instagram (Page-Scoped ID / PSID / IGSID).

typestringobrigatório

Tipo de mensagem a ser enviada. Valores suportados: text, image, audio, video, file.

accountCRMLeadIdstring

ID do Lead a ser associado à conversa caso a conversa ainda não exista no sistema.

senderIdstring

Membro da conta que está enviando a mensagem (opcional): User.id ou id do vínculo, ambos de Listar Membros da Conta. Se não for um membro desta conta, a API responde 404 e a mensagem não é enviada. Se omitido, a mensagem é registrada como enviada por IA/Automação.

Tipos de Mensagem e Payloads

1. Texto (text)

json
{
  "accountIntegrationId": "cmint9876543210",
  "recipientId": "123456789012345",
  "type": "text",
  "text": {
    "body": "Olá! Seja bem-vindo ao nosso atendimento."
  }
}

2. Imagem (image)

json
{
  "accountIntegrationId": "cmint9876543210",
  "recipientId": "123456789012345",
  "type": "image",
  "image": {
    "url": "https://meusite.com/foto.jpg",
    "caption": "Confira nosso catálogo de novidades!"
  }
}

3. Áudio (audio)

json
{
  "accountIntegrationId": "cmint9876543210",
  "recipientId": "123456789012345",
  "type": "audio",
  "audio": {
    "url": "https://meusite.com/audio.mp3"
  }
}

4. Vídeo (video)

json
{
  "accountIntegrationId": "cmint9876543210",
  "recipientId": "123456789012345",
  "type": "video",
  "video": {
    "url": "https://meusite.com/video.mp4"
  }
}

5. Arquivo / Documento (file)

json
{
  "accountIntegrationId": "cmint9876543210",
  "recipientId": "123456789012345",
  "type": "file",
  "file": {
    "url": "https://meusite.com/documento.pdf",
    "name": "Manual.pdf"
  }
}

Exemplos de Envio

Autorização

Tokenstring · headerobrigatório

Token de autenticacao gerado na plataforma WavUps CRM.

Corpo da requisição

application/json · object
accountIntegrationIdstringobrigatório

ID da integração Instagram.

recipientIdstringobrigatório

ID do usuário no Instagram (PSID).

typeenum<string>obrigatório

Valores aceitos: text, image, audio, video, file

accountCRMLeadIdstring

ID do lead opcional caso a conversa ainda não exista.

senderIdstring | null

Membro da conta enviando a mensagem: User.id ou id do vínculo (GET /account-user). Fora da conta: 404 e nada é enviado.

textobject
imageobject
audioobject
videoobject
fileobject

Respostas

200application/json · object

Mensagem enfileirada com sucesso.

messagestring
Exemplo: "Instagram message send task queued successfully."
400

Payload inválido.

404

Integração não encontrada.

500