Enviar texto, mídia, localização, reação ou sticker via Instagram Meta API.
Nó Instagram
O nó Instagram (instagram_send) envia mensagens Direct via Instagram (Meta API): texto, mídia, localização ou reação. Requer instância conectada ao Instagram e PSID do destinatário (Page-Scoped ID).
Encontre-o na paleta WhatsWave em Automações.
Figura 1: Nó Instagram — operação text com instância e PSID
O que faz
| Aspecto | Comportamento |
|---|---|
| Node type | instagram_send |
| Executor | http_request |
| Auth | Authorization: Bearer {{api_token}} + X-WhatsWave-Sent-By: workflow |
| Outputs | key, status, message |
As operações compartilham os mesmos paths da API de mensagens do WhatsApp Send, mas exigem canal Instagram na instância e destino PSID.
Campos compartilhados (todas as operações)
| Campo | Key | Obrigatório | Descrição |
|---|---|---|---|
| Company | company_id | Auto | Oculto |
| Instagram instance | instance_id | Sim | Instance picker — canal instagram |
| Recipient PSID | number | Sim | Page-Scoped ID, não número de telefone |
Operation templates
Text (ig_op_text)
| Campo | Key | Descrição |
|---|---|---|
| Message | text | Corpo do DM em texto |
Endpoint: POST /instances/message/send-text
Media (ig_op_media)
| Campo | Key | Descrição |
|---|---|---|
| Media type | media_type | image, video, audio ou document |
| Media | media | URL ou upload |
| Storage path | mediaStoragePath | Oculto ao fazer upload |
| Caption | caption | Legenda opcional |
Endpoint: POST /instances/message/send-media
Location (ig_op_location)
| Campo | Key | Descrição |
|---|---|---|
| Latitude | latitude | Graus decimais |
| Longitude | longitude | Graus decimais |
| Place name | name | Rótulo do local |
| Address | address | String de endereço |
Endpoint: POST /instances/message/send-location
Nota: as keys são latitude/longitude no Instagram (WhatsApp Send usa lat/lng).
Reaction (ig_op_reaction)
| Campo | Key | Descrição |
|---|---|---|
| Message ID | message_id | ID da mensagem alvo |
| Emoji | emoji | Emoji da reação, padrão 👍 |
| Sent by me | from_me | true ou false — se o alvo é mensagem de saída |
Endpoint: POST /instances/message/send-reaction
Dicas e boas práticas
- PSID não é telefone — capture de payloads de webhook Meta (
sender.id) ou APIs do inbox. - Filtre instâncias pelo canal Instagram — canal errado causa erros de API.
- Janela de mensagens de 24 horas se aplica como no WhatsApp — respeite política Meta para conteúdo promocional.
- Campo de mídia é
mediano Instagram vsmediaUrlno WhatsApp Send — use o nó correto para cada canal. - Verifique conexão da instância com nó Instances antes de campanhas.
Exemplos de uso
Exemplo 1 — Responder a webhook de DM Instagram
Trigger: Webhook — evento de mensagem Instagram.
Fluxo:
- Instagram — Text
instance_id: linha IG conectadanumber:{{trigger.body.sender_psid}}text: "Thanks for your message! We'll reply shortly."
- CRM — upsert com PSID armazenado em metadata
Exemplo 2 — Enviar imagem de produto
Trigger: Webhook — consulta de catálogo.
Fluxo:
- Instagram — Media
media_type:imagemedia:{{trigger.body.image_url}}caption: nome e preço do produto
Exemplo 3 — Reagir a mensagem do cliente
Trigger: Webhook — feedback positivo.
Fluxo:
- Instagram — Reaction
message_id:{{trigger.body.message_id}}emoji: ❤️from_me:false
FAQ
Posso usar nó WhatsApp Send com PSID?
O nó Send aceita PSID em number para instâncias multicanal, mas o nó Instagram força instance picker Instagram e nomes de campo específicos de IG.
Suporte a sticker?
A operação sticker existe em mapas de campo para compatibilidade legada, mas não está no seletor padrão — use mídia ou texto em fluxos normais.
Onde obtenho PSID?
De webhooks de mensagens Instagram da Meta quando um usuário envia DM para sua conta conectada.
Diferença entre message_id e messageId do WhatsApp?
Reação Instagram usa snake_case message_id; Send Reaction WhatsApp usa messageId.
Artigos relacionados
Este artigo foi útil?
Precisa de mais ajuda? Falar com suporte