I rompighiaccio consentono agli utenti di iniziare una conversazione con un'azienda con una lista di FAQ. Con l'API Ice Breaker è possibile impostare al massimo 4 domande.
A partire dal 19 ottobre 2021, i rompighiaccio supportano la localizzazione per consentire alle aziende di impostare domande personalizzate a seconda della lingua dell'utente. L'API avrà un nuovo formato e incoraggiamo gli sviluppatori a utilizzarlo per impostare e recuperare le informazioni relative ai rompighiaccio. La lista delle lingue supportate è disponibile qui.
Al momento, questa funzione non è disponibile su computer.
curl -X POST -H "Content-Type: application/json" -d '{
"platform": "instagram",
"ice_breakers":[
{
"call_to_actions":[
{
"question":"
curl -X POST -H "Content-Type: application/json" -d '{
"platform": "instagram",
"ice_breakers":[
{
"question": "
A seconda della modalità di configurazione del rompighiaccio, la richiesta GET restituirà un formato diverso. Si applica il seguente comportamento:
Incoraggiamo gli sviluppatori a effettuare la migrazione al nuovo formato perché in futuro dichiareremo obsoleto il vecchio formato.
curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>
Risposta del nuovo formato
{
"data": [
{
"call_to_actions" : [
{
"question": "
Risposta del formato precedente
{
"data": [
{
"ice_breakers": [
{
"question": "
curl -X DELETE -H "Content-Type: application/json" -d '{
"fields": [
"ice_breakers",
]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"
Per ricevere i Webhooks di postback dai rompighiaccio, l'app deve essere iscritta al Webhook messaging_postbacks
v8.0+ nell'argomento Instagram nelle impostazioni dell'app.
Il webhook riceverà un payload json simile all'esempio sottostante.
{ "object": "instagram", "entry": [ { "id": "<IGID>", "time": 1502905976963, "messaging": [ { "sender": { "id": "<IGSID>" }, "recipient": { "id": "<IGID>" }, "timestamp": 1502905976377, "postback": { "title": "<SELECTED_ICEBREAKER_QUESTION>", "payload": "<USER_DEFINED_PAYLOAD>", } } ] } ] }