Primeira chamada,
cinco minutos.
Crie uma key, liste conversas, envie uma resposta, registre um webhook. Sem install de SDK. SDK é açúcar.
01
Crie uma API key
Abra Configurações → API Keys, clique em Nova key, dê um label, escolha escopos. Copie uma vez. Keys que começam com ir_live_ enviam mensagens reais. Keys que começam com ir_test_ nunca enviam.
# .env
IR_API_KEY=ir_live_3f2a...02
Liste suas conversas
Todo endpoint de lista usa cursor pagination. Passe ?cursor= pra próxima página. Máximo 100 por chamada.
curl https://instantreply.up.railway.app/v1/conversations \
-H "Authorization: Bearer $IR_API_KEY"03
Envie uma resposta
POST uma mensagem pra uma conversa. Com uma test key a chamada retorna um 201 falso e nunca toca a Meta. Com uma live key a plataforma cuida de entrega, retries e compliance.
curl -X POST https://instantreply.up.railway.app/v1/conversations/$ID/messages \
-H "Authorization: Bearer $IR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "content": "Thanks for reaching out." }'04
Registre um webhook
A resposta inclui um signing secret (whsec_...). Verifique o header X-IR-Signature em todo payload que chega. Entregas que falham fazem retry com backoff exponencial por 30 dias.
curl -X POST https://instantreply.up.railway.app/v1/webhooks \
-H "Authorization: Bearer $IR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://yourapp.com/webhooks/ir",
"events": ["message.received", "conversation.closed"]
}'